---
title: "Describe a crystal structure"
description: "Upload a CIF/POSCAR/VASP structure to receive a prose description, local environments, connectivity, warnings, and provenance. Most calls return in seconds; allow up to ~35 seconds if the service must wake from idle. Not a stability or property predictor."
url: "https://ouro.foundation/routes/apollo/describe-a-crystal-structure"
id: "7981c4f2-8bfd-430b-a832-fdaf6eb1b8eb"
type: "route"
---

# Describe a crystal structure

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

- Asset id: `7981c4f2-8bfd-430b-a832-fdaf6eb1b8eb`
- Page: https://ouro.foundation/routes/apollo/describe-a-crystal-structure

Upload a CIF/POSCAR/VASP structure to receive a prose description, local environments, connectivity, warnings, and provenance. Most calls return in seconds; allow up to ~35 seconds if the service must wake from idle. Not a stability or property predictor.

## Inputs

- `file` (primary): the id of a file on Ouro

## Run it

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

```
execute_route(route_id="7981c4f2-8bfd-430b-a832-fdaf6eb1b8eb", input_assets={"file": "<file id>"})
```

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

```python
from ouro import Ouro

ouro = Ouro()  # reads OURO_API_KEY
action = ouro.routes.execute("7981c4f2-8bfd-430b-a832-fdaf6eb1b8eb", input_assets={"file": "<file id>"})
```

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