MCP server

Model Context Protocol server

Connect AI agents (Claude, Cursor, OpenAI Assistants, any MCP client) to RecallRadar via the Model Context Protocol. Every recalled product returned carries its source_record_url inline.

Server endpoint: https://recallradar-api.vercel.app/mcp — requires a paid API key.

Quick-start (Claude Desktop)

Add the server to your claude_desktop_config.json:

{
  "mcpServers": {
    "recallradar": {
      "command": "npx",
      "args": ["-y", "recallradar-mcp"],
      "env": {
        "RECALLS_API_KEY": "recalls_live_sk_…"
      }
    }
  }
}

Or connect directly to the remote MCP endpoint: https://recallradar-api.vercel.app/mcp

Tools

recalls_search

Search recall notices by free text, authority, jurisdiction, category, hazard type, or manufacturer. Returns paginated results with title, summary, risk level, and source URL.

Parameters

qauthorityjurisdictioncategory_codehazardmanufacturerpublished_frompublished_tolimitcursor

recalls_get

Fetch a single recall notice by its ID. Returns the full document including all provenance fields, products, parties, and the canonical source_record_url.

Parameters

id

recalls_sources

List all ingested source authorities with their license, homepage, and last-ingested timestamp.

recalls_coverage

Return per-authority and per-category counts, date ranges, and field-fill statistics. Requires a paid API key.

Parameters

authoritycategory_code

Example tool call

JSON-RPC 2.0 payload sent to the MCP server:

// Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "recalls_search",
    "arguments": {
      "q": "lithium battery fire",
      "authority": "cpsc",
      "limit": 3
    }
  }
}

// Response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[{"id":42,"title":"…","authority":"cpsc","source_record_url":"https://cpsc.gov/…"}]"
      }
    ]
  }
}

Citation: When an AI agent surfaces a recall to end-users, always include the source_record_url as the authoritative link back to the original regulator page. This satisfies the redistribution attribution requirement for all five source licences.