@verify-api/mcp

VerifyAPI MCP server

A tiny stdio Model Context Protocol server that wraps the VerifyAPI REST endpoints. Install it into any MCP-capable client (Claude Desktop, Cursor, Windsurf, VS Code with the MCP extension, ChatGPT Desktop, custom agents built on the MCP SDKs) and the model gets one tool:

• verify_claim — check a factual claim, get back {verdict, confidence, source_url, exact_quote, published_date}.

The server is a thin adapter: your API key lives in the client's env, one HTTPS call per invocation, no state. Because it is the same account and same billing surface as REST callers, every MCP verification counts toward the same balance and idempotency semantics.

Install (Claude Desktop, Cursor, Windsurf)

npm install -g @verify-api/mcp   # (once published; for now, npm link from this dir)

Add to your MCP client config (e.g. ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "verifyapi": {
      "command": "verifyapi-mcp",
      "env": {
        "VERIFYAPI_API_KEY": "csk_live_...",
        "VERIFYAPI_BASE_URL": "https://api.verify-api.dev"
      }
    }
  }
}

Restart the client. The verify_claim tool now shows up in the model's tool list.

Run from source (during development)

cd mcp
npm install
npm run build
VERIFYAPI_API_KEY=csk_test_... VERIFYAPI_BASE_URL=http://localhost:8080 node dist/server.js

Then in your MCP client config point command at that node dist/server.js path.

What the model sees

Tool name: verify_claim Tool description:

Verify a single factual claim against live web sources. Returns one of supported, refuted, insufficient_evidence, or out_of_scope, with confidence, a source URL, and a verbatim quote. Costs $0.02 per successful verification (unsupported/refuted); free otherwise. Use this when you need to check a specific fact before acting on it.

Input schema:

{
  "claim": "string (a single factual claim, ideally < 300 chars)",
  "as_of": "string (ISO date, optional — for time-sensitive facts)",
  "max_wait_ms": "number (optional, default 15000)"
}

Return value: the JSON body of POST /v1/verify, unmodified.