Equilibrium Labs Docs
v0.1
Changelog GitHub
Menu

MCP server

MCP tools

The Equilibrium MCP server exposes three tools. All three return citations and a confidence band as part of the response payload, not as an optional field — see the overview for why that’s a fixed design choice rather than a default.

validate_claim

Runs a quantitative claim through claimcheck and returns the sources, assumptions, and confidence band behind it. This is a direct wrapper around claimcheck.validate.

JSON
{
  "tool": "validate_claim",
  "arguments": {
    "claim": "AI raised task exposure 14% in 2025"
  },
  "response": {
    "claim": "AI raised task exposure 14% in 2025",
    "point_estimate": 0.14,
    "confidence_band": [0.09, 0.19],
    "evidence": [
      {
        "source_id": "task-exposure-bounds-2026",
        "citation": "Measuring labour displacement without a counterfactual, 2026",
        "retrieved": "2026-07-09"
      }
    ],
    "assumptions": [
      "onet-taxonomy-mapping",
      "task-mix-stability-2025"
    ]
  }
}

generate_synthetic_sample

Runs a generator and returns a sample plus its provenance manifest, without requiring the calling model to shell out or write files directly. This wraps synthetic.generate.

JSON
{
  "tool": "generate_synthetic_sample",
  "arguments": {
    "generator": "household_panel",
    "n": 500,
    "seed": 20260801
  },
  "response": {
    "run_id": "hp-20260801-7f3a1c",
    "rows_generated": 500,
    "sample_uri": "https://data.equilibriumlabs.org/runs/hp-20260801-7f3a1c/sample.parquet",
    "manifest": {
      "generator_version": "3.1.0",
      "calibration_target": "eu-silc-2023-v2",
      "seed": 20260801
    }
  }
}

lookup_source

Looks up a single entry in the source registry by ID, or searches it by keyword.

JSON
{
  "tool": "lookup_source",
  "arguments": {
    "source_id": "eurostat-silc-income-2023"
  },
  "response": {
    "source_id": "eurostat-silc-income-2023",
    "title": "EU-SILC Income and Living Conditions, 2023 release",
    "publisher": "Eurostat",
    "license": "CC BY 4.0",
    "access_terms": "open, no registration",
    "retrieval_date": "2026-05-11"
  }
}
View source on GitHub