io.github.zyfy-uk/zyfy-mcp
MCP server for Zyfy — UK postcode and vehicle intelligence for Claude and other AI agents
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
@zyfy-uk/mcpclaude mcp add zyfy-mcp -e 'YOUR_API_KEY=<your your_api_key>' -- npx -y @zyfy-uk/mcp@0.1.1
{
"mcpServers": {
"zyfy-mcp": {
"command": "npx",
"args": [
"-y",
"@zyfy-uk/mcp@0.1.1"
],
"env": {
"YOUR_API_KEY": "<your your_api_key>"
}
}
}
}
Variables d'environnement
YOUR_API_KEYobligatoire secret Your API key for the service
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
@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.jsonif it contains your API key — add.mcp.jsonto your.gitignore.For a global setup (applies to all projects), add the same block to
~/.claude.jsoninstead.
The same .mcp.json format works in Cursor and any other MCP-compatible client.
Available tools
| Tool | Description |
|---|---|
lookup_postcode | Flood risk, crime rate, broadband coverage, average property price, deprivation index (IMD), and MP details for any UK postcode |
lookup_vehicle | Make, MOT history, tax/MOT status and expiry, ULEZ compliance, safety score, and odometer trend for any UK vehicle registration |
nearest_postcode | Full enrichment data for the nearest postcode to a lat/lon coordinate |
postcodes_within | All 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
Questions fréquentes
Qu'est-ce que io.github.zyfy-uk/zyfy-mcp ?
MCP server for Zyfy — UK postcode and vehicle intelligence for Claude and other AI agents
Comment installer io.github.zyfy-uk/zyfy-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add zyfy-mcp -e 'YOUR_API_KEY=<your your_api_key>' -- npx -y @zyfy-uk/mcp@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.zyfy-uk/zyfy-mcp ?
Oui. Il attend YOUR_API_KEY, à renseigner dans sa configuration.
io.github.zyfy-uk/zyfy-mcp est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient io.github.zyfy-uk/zyfy-mcp ?
Il est publié par zyfy-uk. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.