MCP Tools

REST endpoint for MCP tool discovery. Returns all registered tools with parameters, trust tiers, and expected durations. Requires Clerk JWT auth.

MCP Tools

The MCP Tools endpoint exposes the tool registry, allowing clients to discover available tools, their parameters, trust tiers, and expected durations.

GET/api/mcp-toolsAUTH

List all registered MCP tools.

Response

[
  {
    "name": "goldencheck",
    "description": "Profile and validate data quality for a source",
    "category": "quality",
    "tier": "read",
    "duration": "fast",
    "params": [
      { "name": "source_id", "type": "string", "required": true, "description": "Source to profile" }
    ]
  },
  {
    "name": "goldenmatch",
    "description": "Probabilistic record linkage and deduplication",
    "category": "matching",
    "tier": "write",
    "duration": "slow",
    "params": [
      { "name": "source_id", "type": "string", "required": true, "description": "Source to match against" },
      { "name": "threshold", "type": "number", "required": false, "description": "Confidence threshold (0.0-1.0)" }
    ]
  }
]

Metadata Fields

FieldTypeDescription
namestringUnique tool identifier
descriptionstringHuman-readable summary of what the tool does
categorystringFunctional category (e.g. quality, matching, transform, orchestration, schema)
tierstringTrust tier — read (no side effects) or write (mutates data). Used by the trust gate.
durationstringExpected execution time — fast (< 5s) or slow (5s+)
paramsarrayList of parameter definitions with name, type, required, and description
Was this page helpful?
Edit this page on GitHub