MoPro-Codex
Movement Intelligence API
Exercise ontology, biomechanics interpretation, alias search, parent-child variation trees, graph-domain mapping and figure requirements for fitness, rehab, coaching, sport science, education and AI platforms.
One header. Every endpoint.
Authentication
Every protected endpoint takes the same header. Keys are issued during the private beta by MMSx Authority — placeholder shown; never publish a real key.
Authorization: Bearer YOUR_API_KEY
Live-look call
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.mopro-codex.com/v3/exercise/search?q=rdl"
{
"query": "rdl",
"resolved": true,
"results": [
{
"canonical_exercise_name": "Romanian Deadlift",
"exercise_id": "MMSX-BE-00412",
"movement_family": "hinge",
"confidence": 0.99
}
],
"safety_boundary": "Educational decision-support only; not medical diagnosis."
}
const BASE = "https://api.mopro-codex.com";
const res = await fetch(`${BASE}/v3/exercise/search?q=back%20squat`, {
headers: { Authorization: "Bearer YOUR_API_KEY" },
});
if (!res.ok) {
const err = await res.json(); // { ok:false, error:"...", message:"..." }
throw new Error(`${err.error}: ${err.message}`);
}
const data = await res.json();
console.log(data.results[0].canonical_exercise_name); // "Back Squat"
console.log(res.headers.get("x-mmsx-monthly-remaining"));
import requests
BASE = "https://api.mopro-codex.com"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}
r = requests.get(f"{BASE}/v3/exercise/profile",
params={"name": "Back Squat"}, headers=HEADERS)
r.raise_for_status()
profile = r.json()
print(profile["canonical_exercise_name"]) # Back Squat
print(profile["movement_family"])
print(r.headers["x-mmsx-monthly-remaining"])
Everything in the beta surface
Eight exercise-intelligence endpoints, the key-management set, and public plan/health routes. Full parameters in the API reference. No code needed — Try API in Browser.
?q=?name=?name=?name=?name=?name=?name=?limit=Six plans. One matrix.
Access levels are enforced per endpoint — full, basic (trimmed record), or excluded. Details on the pricing page.
| Endpoint | Free Sandbox | Developer | Professional | Clinic / Team | Institution | Enterprise |
|---|---|---|---|---|---|---|
| Monthly quota | 100 requests / month | 10,000 requests / month | 50,000 requests / month | 150,000 requests / month | 500,000 requests / month | Custom |
| Search | full | full | full | full | full | full |
| Profile | basic | full | full | full | full | full |
| Tree | — | full | full | full | full | full |
| Children | — | full | full | full | full | full |
| Aliases | — | full | full | full | full | full |
| Graph domains | — | basic | full | full | full | full |
| Figures | — | basic | full | full | full | full |
| Reports / widgets (later) | — | — | — | full | full | full |
| Institution workflows (later) | — | — | — | — | full | full |
Example API response
Every payload carries review status, confidence, and the evidence/safety boundary. Eight worked examples on the examples page.
{
"review_status": "uploaded_base_parent",
"confidence": 1.0,
"evidence_boundary": "Generated ontology, ready for MMSx expert review. Do not claim all records are fully validated.",
"safety_boundary": "Educational decision-support only; not medical diagnosis.",
"exercise_id": "MMSX-BE-00018",
"canonical_exercise_name": "Back Squat",
"canonical_key": "back_squat",
"node_type": "BASE",
"movement_family": "general_fitness",
"parent_name": null,
"access_tier": null,
"access_tier_note": null,
"graph_domains": {
"domains": [
"compensation_risk",
"fatigue_decay",
"implement_path",
"… +9 more"
],
"summary": {
"compensation_risk": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"joint_angle": {
"increased": 0,
"decreased": 0,
"baseline": 4
},
"phase_timing": {
"increased": 2,
"decreased": 0,
"baseline": 4
},
"progression_readiness": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"stability_demand": {
"increased": 2,
"decreased": 0,
"baseline": 0
},
"implement_path": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"torque": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"vector_direction": {
"increased": 1,
"decreased": 0,
"baseline": 0
},
"fatigue_decay": {
"increased": 2,
"decreased": 0,
"baseline": 0
},
"load_tolerance": {
"increased": 2,
"decreased": 0,
"baseline": 0
},
"repetition_quality_decay": {
"increased": 2,
"decreased": 0,
"baseline": 0
},
"rom_control": {
"increased": 2,
"decreased": 0,
"baseline": 0
}
},
"rows": [
{
"parent_name": "Back Squat",
"child_name": "Assisted Back Squat",
"graph_domain": "compensation_risk",
"parent_relevance": "baseline",
"child_relevance": "increased",
"delta_reason": "External support reduces balance demand and allows pattern learning.",
"confidence": 0.91
},
{
"parent_name": "Back Squat",
"child_name": "Assisted Back Squat",
"graph_domain": "joint_angle",
"parent_relevance": "baseline",
"child_relevance": "same",
"delta_reason": "Core movement identity remains inherited from parent.",
"confidence": 0.91
},
{
"parent_name": "Back Squat",
"child_name": "Assisted Back Squat",
"graph_domain": "phase_timing",
"parent_relevance": "baseline",
"child_relevance": "same",
"delta_reason": "Core movement identity remains inherited from parent.",
"confidence": 0.91
},
"… +22 more"
]
}
}
Predictable error bodies
Machine-readable error codes with
stable JSON shapes. Full guide with fixes on the
error reference.
Educational decision-support only
The API does not diagnose, does not prescribe medical treatment, does not replace professional judgement, and does not claim measured laboratory validity unless measured data are supplied. Read the full boundary.
Generate any client today from openapi.json · SDK page
Embeddable widgets are a later API phase — placeholder documentation.
Request Beta Access
MoPro-Codex is in private developer beta. Keys are issued directly by MMSx Authority with a plan attached.
MoPro-Codex by TrainersEye Start Quickstart