Nexus API & MCP docs
Fastest start: connect HumanMirror in 30 seconds. HumanMirror One is the recommended minimal MCP default; use Nexus when broader discovery and routing are needed.
Nexus is a provider-aware routing and metering layer. Catalog search is free. Routed calls consume the credit cost declared by the selected tool.
Quick start — 500 free credits
curl -X POST https://humanmirror.fr/api/nexus/trialThe API returns a plaintext key once. Store it securely.
Authentication
Authorization: Bearer hm_nexus_YOUR_KEYGET /api/nexus/search?q=…
Free endpoint. Returns matching tools with tool_id, provider, description, input schema and cost_credits.
curl "https://humanmirror.fr/api/nexus/search?q=anomaly+numeric"POST /api/nexus/call
{
"tool_id": "forge.detect_anomaly",
"input": [10, 11, 12, 13, 60]
}The declared tool cost is reserved atomically before execution. If the provider execution fails, the reserved credits are refunded.
Current catalog
forge.clean_json · 1forge.dedupe_records · 1forge.normalize_entity · 1forge.score_data_quality · 2forge.detect_anomaly · 2sentinel.inspect_output · 2trace.issue_receipt · 2lens.infer_schema · 1lens.diff_contract · 2vault.scan_secrets · 1circuit.preflight · 1outcome.run · 5one.do · 6flow.run · 12
The AgentOps family is documented at humanmirror.fr/agentops/. Trace also exposes a free public receipt verifier at /api/trace/verify/.
Remote MCP
Endpoint: https://humanmirror.fr/api/nexus/mcp/.
Six MCP tools are exposed:
outcome_quote— free deterministic Outcome quote;outcome_run— verified Outcome execution, 5 credits on verified success;outcome_verify— free deterministic re-verification;nexus_search— free catalog discovery;magnet_resolve— free fallback discovery when the current toolset cannot satisfy a task; it either returns a matching HumanMirror capability or records an aggregated capability gap;nexus_call— authenticated direct routed execution.
For the smallest MCP surface, prefer HumanMirror One, which exposes exactly one tool. For 2–3 verified steps, use HumanMirror Flow.
{
"mcpServers": {
"humanmirror-nexus": {
"url": "https://humanmirror.fr/api/nexus/mcp/",
"headers": {
"Authorization": "Bearer $HUMANMIRROR_NEXUS_KEY"
}
}
}
}Pricing
Nexus catalog search and HumanMirror Magnet fallback discovery are free. Trial: 100 execution credits. Paid pack: 5,000 credits for €9.99, one-time payment. Tool execution costs are declared in the catalog and may differ by tool.
Provider model
The live first-party catalog currently contains HumanMirror Forge, Sentinel, Trace, Lens, Vault, Circuit, Outcome, One and Flow. The database and ledger remain provider-aware. External provider self-onboarding and payouts are not represented as generally available until the payment, compliance and payout flow is production-ready.