@zyfy-uk/mcp

MCP server for Zyfy — UK postcode and vehicle intelligence for Claude, Cursor, and other AI agents.

Add this server to Claude Desktop, Claude Code, or Cursor and ask natural language questions about UK postcodes and vehicles. No code required.

Prerequisites

• Node.js 18 or later
• A Zyfy API key — sign up free at zyfy.uk (free tier includes 100 requests/month). Your key will look like ea_live_....

Setup

Claude Desktop

Add to your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "zyfy": {
      "command": "npx",
      "args": ["-y", "@zyfy-uk/mcp"],
      "env": {
        "ZYFY_API_KEY": "ea_live_your_key_here"
      }
    }
  }
}

Restart Claude Desktop after saving the file.

Claude Code

Add a .mcp.json file in your project root:

{
  "mcpServers": {
    "zyfy": {
      "command": "npx",
      "args": ["-y", "@zyfy-uk/mcp"],
      "env": {
        "ZYFY_API_KEY": "ea_live_your_key_here"
      }
    }
  }
}

Note: Do not commit .mcp.json if it contains your API key — add .mcp.json to your .gitignore.

For a global setup (applies to all projects), add the same block to ~/.claude.json instead.

The same .mcp.json format works in Cursor and any other MCP-compatible client.

Available tools

See zyfy.uk/docs for the full response schema and signal reference.

Example prompts

• What's the flood risk at SW1A 2AA?
• Is AB12 CDE ULEZ compliant, and when does its MOT expire?
• What's the average property price and crime rate for the postcode nearest to 51.5074, -0.1278?
• List all postcodes within 500 metres of 51.5, -0.1 and their flood risk bands.

Quota

Each tool call uses one quota unit from your Zyfy account. postcodes_within uses one unit per postcode returned. Your remaining quota is included in every response. See zyfy.uk/pricing for plan details.

When your quota is exhausted, tools return a message with the reset date and a link to upgrade. When you hit the per-minute rate limit, tools return a message with how many seconds to wait.

If a response includes "enrichmentPending": true, Zyfy is still processing that record in the background. The result contains the best available data — retry in a few seconds for a complete result.

License

MIT