---
title: "Crystal structure prediction"
description: "Predict crystal structures for given compositions. Atom types are held fixed; the model samples coordinates and lattice."
url: "https://ouro.foundation/routes/mmoderwell/crystal-structure-prediction"
id: "051b8996-3299-4964-8fa3-05b0acdba77a"
type: "route"
---

# Crystal structure prediction

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

- Asset id: `051b8996-3299-4964-8fa3-05b0acdba77a`
- Page: https://ouro.foundation/routes/mmoderwell/crystal-structure-prediction

Predict crystal structures for given compositions. Atom types are held fixed; the model samples coordinates and lattice.

## 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 |
| --- | --- | --- | --- |
| seed | integer | 123 | Random seed |
| factor | integer | 1 | Multiplies the composition formula unit (e.g. TiO2 with fac… |
| n_samples | integer | 4 | Candidates generated per composition |
| checkpoint | "mp20" \| "mpts52" | "mp20" | CSP checkpoint. mp20 supports ≤20 atoms; mpts52 supports ≤5… |
| **compositions** (required) | string[] |  | Chemical compositions (e.g. ['TiO2', 'LiMnO4']) |
| sample_num_steps | integer | 400 | Diffusion steps |

## Run it

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

```
execute_route(route_id="051b8996-3299-4964-8fa3-05b0acdba77a", body={"compositions":"..."})
```

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

```python
from ouro import Ouro

ouro = Ouro()  # reads OURO_API_KEY
action = ouro.routes.execute("051b8996-3299-4964-8fa3-05b0acdba77a", body={"compositions":"..."})
```

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