---
title: "Predict a crystal structure"
description: "Simple CSP endpoint: predict a structure for one composition and return a single CIF."
url: "https://ouro.foundation/routes/mmoderwell/predict-a-crystal-structure"
id: "3edfa4fd-d854-416a-a2bc-94999c6c2b30"
type: "route"
---

# Predict a crystal structure

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

- Asset id: `3edfa4fd-d854-416a-a2bc-94999c6c2b30`
- Page: https://ouro.foundation/routes/mmoderwell/predict-a-crystal-structure

Simple CSP endpoint: predict a structure for one composition and return a single CIF.

## 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 | Seed |
| factor | integer | 1 | Stoichiometry factor |
| n_samples | integer | 4 | Candidates to generate; the first successful CIF is returned |
| checkpoint | "mp20" \| "mpts52" | "mp20" | Checkpoint |
| **composition** (required) | string |  | Chemical composition (e.g. 'TiO2', 'LiMnO4') |

## Run it

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

```
execute_route(route_id="3edfa4fd-d854-416a-a2bc-94999c6c2b30", body={"composition":"..."})
```

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

```python
from ouro import Ouro

ouro = Ouro()  # reads OURO_API_KEY
action = ouro.routes.execute("3edfa4fd-d854-416a-a2bc-94999c6c2b30", body={"composition":"..."})
```

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