Nexus API & MCP docs
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 — 100 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 · 1
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/.
Three MCP tools are exposed:
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 routed execution.
{
"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 plus HumanMirror Sentinel, Trace, Lens, Vault and Circuit. 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.