---
title: "Export candidate CIF"
description: "Export the single best stored candidate for an exact stoichiometry as a CIF file. Integer multiples of the requested composition are included (e.g. Fe2Co also matches Fe4Co2). Optional filters cover crystal system, energy above hull, and dynamical stability. The CIF and response include provenance ("
url: "https://ouro.foundation/routes/mmoderwell/export-candidate-cif"
id: "91146484-2a65-457a-a2fd-6966a9404632"
type: "route"
---

# Export candidate CIF

Route by @mmoderwell in #materials-science (all) · returns in one call · Free · typical run under a second

- Asset id: `91146484-2a65-457a-a2fd-6966a9404632`
- Page: https://ouro.foundation/routes/mmoderwell/export-candidate-cif

Export the single best stored candidate for an exact stoichiometry as a CIF file. Integer multiples of the requested composition are included (e.g. Fe2Co also matches Fe4Co2). Optional filters cover crystal system, energy above hull, and dynamical stability. The CIF and response include provenance (ggen, Materials Project, or Alexandria). Use this when a downstream route expects one structure file rather than a ZIP bundle.

## 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 |
| --- | --- | --- | --- |
| **formula** (required) | string |  | Exact stoichiometry to export, for example 'Fe2Co' or 'SiO2… |
| crystal_systems | string[] \| null |  | Optional crystal systems to include |
| max_e_above_hull | number \| null |  | Maximum energy above hull in eV/atom |
| dynamically_stable_only | boolean | true | Only consider dynamically stable structures |

## Run it

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

```
execute_route(route_id="91146484-2a65-457a-a2fd-6966a9404632", body={"formula":"..."})
```

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

```python
from ouro import Ouro

ouro = Ouro()  # reads OURO_API_KEY
action = ouro.routes.execute("91146484-2a65-457a-a2fd-6966a9404632", body={"formula":"..."})
```

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