---
title: "Search Materials Project materials"
description: "Search Materials Project summaries using structured filters for formula, chemistry, symmetry, and basic properties."
url: "https://ouro.foundation/routes/mmoderwell/search-materials-project-materials"
id: "c32019e9-92d8-4c95-ac3a-2e3dd029eb40"
type: "route"
---

# Search Materials Project materials

Route by @mmoderwell in #materials-science (all) · returns in one call · Free · typical run ~15 s

- Asset id: `c32019e9-92d8-4c95-ac3a-2e3dd029eb40`
- Page: https://ouro.foundation/routes/mmoderwell/search-materials-project-materials

Search Materials Project summaries using structured filters for formula, chemistry, symmetry, and basic properties.

## Inputs

- No input assets: the body below is the whole request.

## Body parameters

Send only the ones you mean to change; the defaults are tuned.

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| limit | integer | 20 | Maximum number of results to return. |
| chemsys | string \| null |  | Chemical system such as Li-Fe-O or Si-O. |
| formula | string \| null |  | Reduced formula or wildcard formula pattern (e.g. SiO2, ABO… |
| sort_by | "band_gap" \| "density" \| "energy_above_hull" \| "formatio… |  | Optional client-side sort field. |
| elements | string[] \| null |  | Required elements that must be present. |
| is_metal | boolean \| null |  | Filter metallic vs non-metallic materials. |
| is_stable | boolean \| null |  | Filter by thermodynamic stability. |
| sort_order | "asc" \| "desc" | "asc" | Sort direction when sort_by is provided. |
| theoretical | boolean \| null |  | Filter theoretical-only entries. |
| band_gap_max | number \| null |  | Maximum band gap in eV. |
| band_gap_min | number \| null |  | Minimum band gap in eV. |
| material_ids | string[] \| null |  | Specific Materials Project IDs to look up (accepts bare num… |
| num_sites_max | integer \| null |  | Maximum number of sites in the structure. |
| num_sites_min | integer \| null |  | Minimum number of sites in the structure. |
| crystal_system | string \| null |  | Crystal system filter (triclinic, monoclinic, orthorhombic,… |
| exclude_elements | string[] \| null |  | Elements that must not be present. |
| spacegroup_number | integer \| null |  | Space group number. |
| spacegroup_symbol | string \| null |  | Space group Hermann-Mauguin symbol, e.g. P4/mmm. |
| energy_above_hull_max | number \| null |  | Maximum energy above hull in eV/atom. |

## Run it

From an agent connected to Ouro MCP (`https://mcp.ouro.foundation/mcp`):

```
execute_route(route_id="c32019e9-92d8-4c95-ac3a-2e3dd029eb40")
```

From Python (`pip install ouro-py`):

```python
from ouro import Ouro

ouro = Ouro()  # reads OURO_API_KEY
action = ouro.routes.execute("c32019e9-92d8-4c95-ac3a-2e3dd029eb40")
```

The call returns the result. Every run is recorded as an action with its inputs, logs and outputs.
