Forge API & MCP docs

Five deterministic micro-tools for AI agents, automations and data pipelines. One successful tool execution consumes one Forge credit.

Quick start — 25 free calls

curl -X POST https://humanmirror.fr/api/forge/trial

The response returns a plaintext key once. Store it securely. One trial is available per network origin every 90 days.

Authentication

Authorization: Bearer hm_forge_YOUR_KEY

Alternative REST header: X-API-Key.

POST /api/forge/run

{
  "tool": "detect_anomaly",
  "input": [10, 11, 12, 13, 60],
  "options": {}
}

Maximum serialized input size: 200,000 characters. Successful calls consume 1 credit. Validation errors, authentication failures, rate limits and failed tool executions do not consume a credit.

Tools

clean_json

Options: trim_strings, remove_empty, normalize_keys, sort_keys.

{"tool":"clean_json","input":{" Full Name ":"  Ada   Lovelace  "},"options":{"remove_empty":true}}

dedupe_records

Input must be an array of JSON objects. Optionally provide options.fields to deduplicate using selected fields instead of the whole canonical record.

{"tool":"dedupe_records","input":[{"id":1,"x":"a"},{"id":1,"x":"b"}],"options":{"fields":["id"]}}

normalize_entity

Accepts a name string or an object containing fields such as name, domain, url and email.

score_data_quality

Accepts a non-empty array of records and returns a 0–100 score, grade, completeness, duplicate rate and per-field type consistency.

detect_anomaly

Accepts a numeric array and returns summary statistics plus outlier positions using IQR and z-score signals.

Response shape

{
  "ok": true,
  "version": "2026-08-30",
  "request_id": "hmforge_…",
  "tool": "detect_anomaly",
  "result": {},
  "usage": {
    "credits_used": 1,
    "credits_remaining": 24
  }
}

Errors

400 invalid_body, 400 unknown_tool, 400 missing_input, 401 invalid_api_key, 402 insufficient_credits, 413 payload_too_large, 429 rate_limited, 503 service_unavailable.

Remote MCP

Endpoint: https://humanmirror.fr/api/forge/mcp/. The server exposes the five tools directly under their names.

{
  "mcpServers": {
    "humanmirror-forge": {
      "url": "https://humanmirror.fr/api/forge/mcp/",
      "headers": {
        "Authorization": "Bearer $HUMANMIRROR_FORGE_KEY"
      }
    }
  }
}

Pricing

Trial: 25 calls. Paid pack: 1,000 credits for €4.99, one-time payment, no subscription. One successful REST or MCP tool call = 1 credit.

Machine-readable assets

OpenAPI 3.1 · MCP Registry server.json · Postman Collection