{
  "markdown": "# PlanWire MCP Server\n\nUse UK planning application data inside Claude, Cursor, and any MCP client.\n\nPlanWire exposes fresh, normalised UK planning application data through a public API. This MCP server wraps that API as agent tools so an assistant can search applications, inspect a specific record, look near a location, and list supported councils without you writing API calls by hand.\n\nGet a free sandbox API key at https://planwire.io/?utm_source=npm&utm_medium=mcp_readme&utm_campaign=mcp.\n\n## What MCP Is\n\nModel Context Protocol (MCP) is a standard way for AI tools to call external services. You run this package locally through `npx`; it talks to PlanWire using your own API key and returns structured planning data to the MCP client.\n\nThis server uses stdio transport. It does not store credentials or run a hosted proxy.\n\n## Install\n\nYou need Node.js 18+ and a PlanWire API key.\n\n```bash\nnpx -y planwire-mcp\n```\n\nUse the package name exactly as shown: `planwire-mcp`. If an MCP directory shows an install command for `beshogun-planwire-mcp`, that directory has stale generated metadata and the install will fail.\n\nThe server expects `PLANWIRE_API_KEY` in the environment. Optional: set `PLANWIRE_API_BASE` to override the default `https://api.planwire.io`.\n\n## Claude Desktop\n\nAdd this to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"planwire\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"planwire-mcp\"],\n      \"env\": {\n        \"PLANWIRE_API_KEY\": \"your_planwire_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop after saving the config.\n\n## Claude Code\n\nAdd this to your project `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"planwire\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"planwire-mcp\"],\n      \"env\": {\n        \"PLANWIRE_API_KEY\": \"your_planwire_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Cursor\n\nAdd the same server command in Cursor's MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"planwire\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"planwire-mcp\"],\n      \"env\": {\n        \"PLANWIRE_API_KEY\": \"your_planwire_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | What it does |\n| --- | --- |\n| `search_planning_applications` | Search by keyword, council, postcode, status, type, or date range. |\n| `nearby_planning_applications` | Find applications near a latitude/longitude point. |\n| `get_planning_application` | Fetch one application by PlanWire application id. |\n| `list_councils` | List covered councils and their IDs. |\n\n## Example Prompts\n\n- \"Search PlanWire for recent planning applications in Camden.\"\n- \"Find refused householder extensions in OX1 from the last year.\"\n- \"What planning applications are within 1km of 51.5074, -0.1278?\"\n- \"List the councils PlanWire covers.\"\n- \"Find planning applications mentioning HMOs in Manchester.\"\n\n## Limits And Pricing\n\nFree sandbox keys are suitable for testing and are capped on daily calls and result size. Paid plans increase limits for production use.\n\nPricing: https://planwire.io/?utm_source=npm&utm_medium=mcp_readme&utm_campaign=mcp#pricing\n\n## Troubleshooting\n\nIf the tool says `PLANWIRE_API_KEY is not set`, add your key to the MCP client config and restart the client.\n\nIf PlanWire returns `401`, check that the key is correct and active.\n\nIf PlanWire returns `429`, the key has reached its rate limit. Use fewer calls or upgrade at https://planwire.io/?utm_source=npm&utm_medium=mcp_readme&utm_campaign=mcp#pricing.\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpm start\n```\n\nMIT licensed. Built by PlanWire: https://planwire.io/?utm_source=npm&utm_medium=mcp_readme&utm_campaign=mcp\n",
  "bytes": 3613,
  "sha": "cbc20d121786f6a16550970d01ffca2a53275810b8f577cc90080e83fbb4a8c9",
  "repo_slug": "beshogun/planwire-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_beshogun_planwire_mcp_f3327e55/readme"
}