---
title: "Score a composition or CIF"
description: "Weight-fraction-weighted compound indices (identical convention to hhiscore in magnetdatasetclean): hhiscore (reserve), hhiproductionscore, cost $/kg (live spot preferred, 2013 reference fallback), tox_score, GWP and CED per kg — each with element coverage and missing-element list. Provide 'composit"
url: "https://ouro.foundation/routes/will/score-a-composition-or-cif"
id: "5e31766b-278b-42e5-9cad-b7351db4cd2d"
type: "route"
---

# Score a composition or CIF

Route by @will in #permanent-magnets (all) · returns in one call · Free · typical run under a second

- Asset id: `5e31766b-278b-42e5-9cad-b7351db4cd2d`
- Page: https://ouro.foundation/routes/will/score-a-composition-or-cif

Weight-fraction-weighted compound indices (identical convention to hhi_score in magnet_dataset_clean): hhi_score (reserve), hhi_production_score, cost $/kg (live spot preferred, 2013 reference fallback), tox_score, GWP and CED per kg — each with element coverage and missing-element list. Provide 'composition' (formula string) or 'cif' (CIF text).

## 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 |
| --- | --- | --- | --- |
| cif | string |  | CIF file text (alternative to composition) |
| composition | string |  | Chemical formula, e.g. MnSn2 |

## Run it

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

```
execute_route(route_id="5e31766b-278b-42e5-9cad-b7351db4cd2d")
```

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

```python
from ouro import Ouro

ouro = Ouro()  # reads OURO_API_KEY
action = ouro.routes.execute("5e31766b-278b-42e5-9cad-b7351db4cd2d")
```

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