How do I use Planning MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Planning MCP Server What's the zoning and land size for 1 Spring Street, Melbourne?" 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.

Planning MCP Server

by andrewjgalea

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

Planning MCP Server v2.0

Model Context Protocol (MCP) server for Australian Planning Property Reports - Cloudflare Workers Edition.

Features

🌍 Global Edge Deployment - Runs on Cloudflare's 300+ edge locations
⚡ High Performance - Parallel API requests and intelligent caching
📊 Comprehensive Data - Property details, zones, overlays, electorates, utilities, and land information
🔒 Production Ready - Rate limiting, authentication, structured logging
📈 Real-time Progress - Progress updates during long-running operations
🚀 HTTP-based MCP - Works with Claude, ChatGPT, and other AI assistants

Related MCP server: Dilix MCP

Quick Start

Prerequisites

Node.js 18+
Cloudflare Workers account
Wrangler CLI (npm install -g wrangler)

Installation

# Clone the project
cd planning-mcp

# Install dependencies
npm install

# Login to Cloudflare
wrangler login

# Create KV namespace for caching
wrangler kv:namespace create "CACHE"
# Copy the ID and add to wrangler.toml

# Start development server
npm run dev

Configuration

Update wrangler.toml with your KV namespace ID
(Optional) Set API key for authentication:
```
wrangler secret put API_KEY
```

Deployment

# Build the project
npm run build

# Deploy to Cloudflare Workers
npm run deploy

Usage

MCP Tool: `vic_planning_property_report`

Retrieves comprehensive Victorian planning property reports. (Additional state tools coming soon.)

Input:

{
  "address": "1 Spring Street, Melbourne VIC 3000",
  "includePdfBase64": false,
  "includeZoneHtml": false,
  "includeOverlayHtml": false
}

Output:

{
  "success": true,
  "address": "1 SPRING STREET MELBOURNE VIC 3000",
  "propertyPfi": "12345",
  "propertyDetails": {
    "address": "1 SPRING STREET MELBOURNE VIC 3000",
    "councilName": "Melbourne City Council",
    "landSize": 842,
    "landSizeHectares": 0.0842,
    "standardParcelIdentifier": "1\\PS123456",
    "registeredAboriginalParty": "Bunurong Land Council",
    ...
  },
  "electorates": {
    "federal": "Melbourne",
    "legislativeAssembly": "Melbourne District",
    "legislativeCouncil": "Southern Metropolitan Region"
  },
  "utilities": {
    "powerDistributor": "AusNet Services",
    "gas": "AusNet Services",
    "melbourneWater": "Melbourne Water",
    "melbourneWaterRetailer": "South East Water"
  },
  "zones": [...],
  "overlays": [...]
}

HTTP API

Health Check:

GET /health

MCP Endpoint:

POST /mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "vic_planning_property_report",
    "arguments": {
      "address": "1 Spring Street, Melbourne VIC 3000"
    }
  }
}

Architecture

┌─────────────────────────────────────────┐
│     Cloudflare Edge Network             │
│  ┌───────────────────────────────────┐  │
│  │   Worker (HTTP MCP Endpoint)      │  │
│  │   - Hono.js Framework             │  │
│  │   - Rate Limiting                 │  │
│  │   - Authentication                │  │
│  │   - CORS                          │  │
│  └───────────────────────────────────┘  │
│               ↓                          │
│  ┌───────────────────────────────────┐  │
│  │   Services Layer                  │  │
│  │   - Address Resolution            │  │
│  │   - Property Data Fetching        │  │
│  │   - Progress Reporting            │  │
│  └───────────────────────────────────┘  │
│               ↓                          │
│  ┌───────────────────────────────────┐  │
│  │   Workers KV (Caching)            │  │
│  │   - 60%+ Cache Hit Rate           │  │
│  │   - 24hr TTL for addresses        │  │
│  └───────────────────────────────────┘  │
└─────────────────────────────────────────┘

Development

Project Structure

planning-mcp/
├── src/
│   ├── index.ts              # Main entry point
│   ├── types/                # TypeScript types
│   ├── services/             # Business logic
│   ├── middleware/           # HTTP middleware
│   ├── handlers/             # MCP handlers
│   ├── lib/                  # Utilities
│   └── schemas/              # Validation schemas
├── test/                     # Tests
├── wrangler.toml            # Cloudflare config
├── tsconfig.json            # TypeScript config
└── package.json             # Dependencies

Testing

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Type check
npm run type-check

Environment Variables

Configure in wrangler.toml:

Variable	Description	Default
`RATE_LIMIT_PER_MINUTE`	Rate limit per IP	100
`CACHE_TTL_HOURS`	Cache TTL in hours	24
`ENABLE_ANALYTICS`	Enable analytics	true
`ALLOWED_ORIGINS`	CORS origins	*

Secrets (use wrangler secret put):

Secret	Description	Required
`API_KEY`	Bearer token for auth	No

Performance

Latency: <5s P50, <8s P95
Cache Hit Rate: >60% after warmup
Throughput: 1000+ req/sec with auto-scaling
Cold Start: <100ms
Memory: <128MB per request

Security

✅ Input validation with Zod
✅ Rate limiting (100 req/min per IP)
✅ Optional API key authentication
✅ CORS configuration
✅ No secrets in logs

Monitoring

Structured Logging

All requests are logged in JSON format with correlation IDs:

{
  "timestamp": "2024-01-30T10:00:00.000Z",
  "level": "info",
  "message": "Tool call started",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "tool": "vic_planning_property_report",
  "metadata": {
    "address": "1 Spring St"
  }
}

Analytics

Enable Cloudflare Analytics Engine for:

Request counts and latency
Cache hit/miss rates
Error tracking
API performance metrics

Deployment Options

Option 1: Cloudflare Workers (Recommended)

300+ edge locations
$5/month base + usage
Lowest latency globally

Option 2: Vercel Edge Functions

See Vercel deployment guide for migration instructions.

Option 3: Oracle Server

Traditional Node.js deployment - see v1.0 branch.

Troubleshooting

Common Issues

KV Namespace not found:

# Create namespace and update wrangler.toml
wrangler kv:namespace create "CACHE"

Rate limit errors:

# Increase limit in wrangler.toml
RATE_LIMIT_PER_MINUTE = "200"

Authentication failures:

# Check API key is set
wrangler secret list
wrangler secret put API_KEY

Contributing

Fork the repository
Create a feature branch
Make your changes
Add tests
Submit a pull request

License

MIT

Support

Documentation: PRD
Issues: GitHub Issues
Discussions: GitHub Discussions

Changelog

v2.0.0 (2024-01-30)

✨ Rewritten for Cloudflare Workers
✨ HTTP-based MCP protocol
✨ Enhanced property data with land size
✨ Real-time progress updates
✨ Parallel API requests
✨ Intelligent caching with Workers KV
✨ Complete field coverage (15+ fields)
🔒 Production-ready security
📊 Structured logging and metrics

v1.0.0

Initial Node.js stdio implementation

Built with ❤️ for Australian planning research

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessSyncing

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

microservices.sh
sh.microservices
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Cloud Platforms Agent Orchestration Developer Tools
21
ai-model-router A
io.github.lazymac2x
Cloudflare Workers MCP server: ai-model-router
Cloud Platforms AI & Machine Learning
32
ai-agent-scratchpad A
io.github.lazymac2x
Cloudflare Workers MCP server: ai-agent-scratchpad
Cloud Platforms Agent Orchestration
62
nyc-property-intel
io.github.ccedacero
MCP server giving Claude AI access to 22+ NYC public-record databases for real estate due diligence
Real Estate Government Data
27

Related MCP Servers

sakutto-mcp-server
SakuttoWorks
F
license
Not graded
quality
Not graded
maintenance
A production-ready MCP server for AI agents, providing deep web research and RAG capabilities via Cloudflare Workers.
Updated 7 months ago (2026-02-17 07:18 UTC)
-
Dilix MCPofficial
Real Estate Finance Government Data
Dilix-Ai
A
license
A
quality
D
maintenance
Open-source MCP server providing real estate regulatory intelligence (zoning, permits, entitlements, deal scoring) for US properties, enabling AI agents to access 10 callable tools.
Updated 3 months ago (2026-06-15 05:06 UTC)
12
9 npm
MIT
UK Property Intelligence
Real Estate Government Data Search
paulieb89
A
license
Not graded
quality
B
maintenance
UK property data MCP server for AI hosts (Claude, ChatGPT). Wraps Land Registry, Rightmove, EPC, rental yields, stamp duty, and Companies House into 13 tools.
Updated 2 months ago (2026-07-17 10:37 UTC)
2
MIT
civic-library-mcp
Government Data Open Data Location Services
adriancisnerosspeed-hub
A
license
A
quality
D
maintenance
An 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.
Updated 3 months ago (2026-06-16 05:21 UTC)
5
27 npm
1
MIT

Appeared in Searches

A search for information about roofs and roofing