Metadata-Version: 2.4
Name: plannexus-mcp
Version: 0.1.0
Summary: MCP server for PlanNexus — query UK planning-application data from Claude, ChatGPT or any MCP client.
Project-URL: Homepage, https://plannexus.io
Project-URL: Documentation, https://plannexus.io/mcp
Author: PlanNexus
License: MIT
License-File: LICENSE
Keywords: claude,llm,mcp,plannexus,planning,planning-applications,uk
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: GIS
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.2.0
Description-Content-Type: text/markdown

# plannexus-mcp

Put **UK planning data inside your AI.** `plannexus-mcp` is an [MCP](https://modelcontextprotocol.io)
server that lets Claude, ChatGPT or any MCP client query [PlanNexus](https://plannexus.io) —
planning applications across ~363 UK local planning authorities — in plain English.

Ask things like *"what's been applied for within 500m of SW1A 1AA this month?"* and your
assistant calls PlanNexus directly.

## Tools

| Tool | What it does |
|------|--------------|
| `search_applications` | Search by free text, postcode, council, or lat/lng + radius, with type/status/date filters |
| `get_application` | Full detail for one application — status, decision, dates, and (on a paid plan) **agent / applicant / case-officer contacts** |
| `get_constraints` | Planning constraints at a postcode or point — conservation area, listed building, Article 4, TPO, flood, green belt, … |
| `find_authority` | Look up a council's id by name |

## Setup (Claude Desktop)

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "plannexus": {
      "command": "uvx",
      "args": ["plannexus-mcp"],
      "env": { "PLANNEXUS_API_KEY": "pn_live_..." }
    }
  }
}
```

Restart Claude and ask away. **Search works without a key** (public preview); add a
[PlanNexus API key](https://plannexus.io) to unlock applicant/agent contacts on a paid plan.

## Run directly

```bash
PLANNEXUS_API_KEY=pn_live_... uvx plannexus-mcp
```

`PLANNEXUS_BASE_URL` overrides the API base (defaults to `https://api.plannexus.io/v1`).

## Licence

MIT
