planwire-mcp
The PlanWire MCP server provides tools to search, explore, and retrieve UK planning application data:
Search planning applications (
search_planning_applications): Search by keyword, council ID, postcode, application status (Pending/Approved/Refused/Withdrawn), type (e.g. Householder, Full, Listed Building), or date range — with pagination and result limits.Find nearby planning applications (
nearby_planning_applications): Locate applications within a specified radius of a given latitude/longitude (WGS84) coordinate.Get a specific planning application (
get_planning_application): Fetch full details of a single application by its unique PlanWire ID.List covered councils (
list_councils): Retrieve all UK local planning authorities (councils) covered by PlanWire, along with their IDs for use in searches.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@planwire-mcp Search for recent planning applications in Camden"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PlanWire MCP Server
Use UK planning application data inside Claude, Cursor, and any MCP client.
PlanWire 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.
Get a free sandbox API key at https://planwire.io/?utm_source=npm&utm_medium=mcp_readme&utm_campaign=mcp.
What MCP Is
Model 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.
This server uses stdio transport. It does not store credentials or run a hosted proxy.
Related MCP server: UK Property Intelligence
Install
You need Node.js 18+ and a PlanWire API key.
npx -y planwire-mcpUse 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.
The server expects PLANWIRE_API_KEY in the environment. Optional: set PLANWIRE_API_BASE to override the default https://api.planwire.io.
Claude Desktop
Add this to claude_desktop_config.json:
{
"mcpServers": {
"planwire": {
"command": "npx",
"args": ["-y", "planwire-mcp"],
"env": {
"PLANWIRE_API_KEY": "your_planwire_key_here"
}
}
}
}Restart Claude Desktop after saving the config.
Claude Code
Add this to your project .mcp.json:
{
"mcpServers": {
"planwire": {
"command": "npx",
"args": ["-y", "planwire-mcp"],
"env": {
"PLANWIRE_API_KEY": "your_planwire_key_here"
}
}
}
}Cursor
Add the same server command in Cursor's MCP settings:
{
"mcpServers": {
"planwire": {
"command": "npx",
"args": ["-y", "planwire-mcp"],
"env": {
"PLANWIRE_API_KEY": "your_planwire_key_here"
}
}
}
}Tools
Tool | What it does |
| Search by keyword, council, postcode, status, type, or date range. |
| Find applications near a latitude/longitude point. |
| Fetch one application by PlanWire application id. |
| List covered councils and their IDs. |
Example Prompts
"Search PlanWire for recent planning applications in Camden."
"Find refused householder extensions in OX1 from the last year."
"What planning applications are within 1km of 51.5074, -0.1278?"
"List the councils PlanWire covers."
"Find planning applications mentioning HMOs in Manchester."
Limits And Pricing
Free sandbox keys are suitable for testing and are capped on daily calls and result size. Paid plans increase limits for production use.
Pricing: https://planwire.io/?utm_source=npm&utm_medium=mcp_readme&utm_campaign=mcp#pricing
Troubleshooting
If the tool says PLANWIRE_API_KEY is not set, add your key to the MCP client config and restart the client.
If PlanWire returns 401, check that the key is correct and active.
If 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.
Development
npm install
npm run build
npm startMIT licensed. Built by PlanWire: https://planwire.io/?utm_source=npm&utm_medium=mcp_readme&utm_campaign=mcp
Available Tools
4 toolsget_planning_applicationA
Fetch a single planning application by its PlanWire id.
Inputs: id (required).
list_councilsA
List the UK councils (local planning authorities) PlanWire covers, with their IDs for use in searches.
Inputs: no named parameters.
nearby_planning_applicationsA
Find planning applications within a radius of a point (latitude/longitude). Use for 'what's been applied for near this location'.
Inputs: lat (required), lng (required), limit, radius_km.
search_planning_applicationsA
Search UK planning applications by keyword, council, postcode, status, type, or date range. Returns matching applications with address, description, reference, status, and dates. Use for questions like 'recent planning applications in Camden' or 'refused extensions in OX1'.
Inputs: q, page, type, limit, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: fetching by ID, listing councils, spatial search, and keyword search. No overlap in functionality.
Most names follow a verb_noun pattern (get, list, search), but 'nearby_planning_applications' omits a verb, creating a slight inconsistency. Otherwise snake_case is used consistently.
Four tools cover the core needs of the domain (search, detail retrieval, council reference) without excess or deficiency.
The set covers essential read operations: keyword search, spatial search, and detail retrieval. A minor gap is the lack of a tool to get an application by reference number, but most workflows are supported.
Related MCP Connectors
UK area & property intelligence for AI agents: reports, EPC, comparables, with source provenance.
Official UK, US and Australia public datasets as filtered CSV, REST API and MCP for AI agents.
MCP server giving Claude AI access to 22+ NYC public-record databases for real estate due diligence
An MCP for marketers that gives agents tools for SEO, AEO, socials and ads data. Generous free tier; works in Claude, ChatGPT, Cursor and other MCP clients.
Related MCP Servers
- AlicenseAqualityDmaintenanceOpen-source MCP server providing real estate regulatory intelligence (zoning, permits, entitlements, deal scoring) for US properties, enabling AI agents to access 10 callable tools.125 npmMIT
- AlicenseNot gradedqualityDmaintenanceUK property data MCP server for AI hosts (Claude, ChatGPT). Wraps Land Registry, Rightmove, EPC, rental yields, stamp duty, and Companies House into 13 tools.2MIT
- AlicenseBqualityBmaintenanceAn MCP server that gives AI assistants access to UK Parliament data. Query MPs, Lords, bills, votes, committees, debates, and more through AI assistants like Claude Desktop and VS Code Copilot.2339MIT
- AlicenseAqualityDmaintenanceAn MCP server that gives AI agents clean, token-efficient access to US civic & property data — geocoding, census tracts, Opportunity Zones, ACS demographics, and FEMA flood zones — sourced entirely from free federal open data.51MIT