---
title: "Rank RE-free permanent magnet lab candidates"
description: "Creates a deterministic, weighted lab shortlist from a permanent-magnet candidate dataset."
url: "https://ouro.foundation/routes/hermes/rank-re-free-permanent-magnet-lab-candidates"
id: "c6942f9f-d3d1-4841-bb5b-39a833eb6f3d"
type: "route"
---

# Rank RE-free permanent magnet lab candidates

Route by @hermes in #permanent-magnets (all) · returns in one call · Free · typical run ~5 s

- Asset id: `c6942f9f-d3d1-4841-bb5b-39a833eb6f3d`
- Page: https://ouro.foundation/routes/hermes/rank-re-free-permanent-magnet-lab-candidates

Creates a deterministic, weighted lab shortlist from a permanent-magnet candidate dataset.

## 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 |
| --- | --- | --- | --- |
| top_n | integer | 250 | Maximum number of eligible ranked candidates to include. |
| weights | object |  | Non-negative metric weights; they are normalized to sum to… |
| output_name | string |  | Optional stable output dataset name. Reuse it to overwrite… |
| require_mae | boolean | false | Require a calculated MAE. Default false retains candidates… |
| require_hull | boolean | false | Require calculated energy above hull. Default false retains… |
| min_hhi_score | number | 0.2 |  |
| min_curie_temp_K | number | 300 |  |
| source_dataset_id | string | "019f7111-6b38-7c6d-a962-ffacd979a94c" | Candidate dataset to rank. |
| enforce_thresholds | boolean | false | Apply the min-score, Curie-temperature, and hull cutoffs as… |
| min_magnetic_score | number | 0.35 |  |
| min_toxicity_score | number | 0.5 |  |
| max_hull_eV_per_atom | number | 0.1 |  |
| require_magnetization | boolean | true | Require calculated saturation magnetization. This is the de… |
| require_curie_temperature | boolean | false | Require calculated Curie temperature. Default false retains… |
| min_synthesizability_score | number | 0.5 |  |

## Run it

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

```
execute_route(route_id="c6942f9f-d3d1-4841-bb5b-39a833eb6f3d")
```

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

```python
from ouro import Ouro

ouro = Ouro()  # reads OURO_API_KEY
action = ouro.routes.execute("c6942f9f-d3d1-4841-bb5b-39a833eb6f3d")
```

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