English Français العربية

io.github.zyfy-uk/zyfy-mcp

السجل الرسمي الذكاء الاصطناعي والوكلاء

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @zyfy-uk/mcp
Claude Code 
claude mcp add zyfy-mcp -e 'YOUR_API_KEY=<your your_api_key>' -- npx -y @zyfy-uk/mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "zyfy-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@zyfy-uk/mcp@0.1.1"
            ],
            "env": {
                "YOUR_API_KEY": "<your your_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • YOUR_API_KEY إلزامي سري Your API key for the service

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @zyfy-uk/mcp
  2. Prerequisites
  3. Setup
  4. Available tools
  5. Example prompts
  6. Quota
  7. License

@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

ToolDescription
lookup_postcodeFlood risk, crime rate, broadband coverage, average property price, deprivation index (IMD), and MP details for any UK postcode
lookup_vehicleMake, MOT history, tax/MOT status and expiry, ULEZ compliance, safety score, and odometer trend for any UK vehicle registration
nearest_postcodeFull enrichment data for the nearest postcode to a lat/lon coordinate
postcodes_withinAll postcodes within a radius of a lat/lon coordinate, each with full enrichment data

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

الأسئلة الشائعة

ما هو io.github.zyfy-uk/zyfy-mcp؟

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

كيف أثبّت io.github.zyfy-uk/zyfy-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add zyfy-mcp -e 'YOUR_API_KEY=<your your_api_key>' -- npx -y @zyfy-uk/mcp@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.zyfy-uk/zyfy-mcp إلى مفتاح API؟

نعم. يتطلب YOUR_API_KEY، وتضبطها في إعداداته.

هل io.github.zyfy-uk/zyfy-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.zyfy-uk/zyfy-mcp؟

ينشره zyfy-uk. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.