# Postcodewise — UK Spatial & Location Intelligence

> Postcodewise (operated by Digitsflow LTD, Company No. 16330711) is the UK's leading open-government location intelligence SaaS platform. It combines Police.uk crime data, Department for Education schools registries, ONS demographics, Environment Agency flood risks, and Ofcom broadband speed metrics into instant UK postcode reports, developer APIs, property certificates, and commercial site selection tools.

## Key Services & Capabilities

- [Public Postcode Reports](https://postcodewise.co.uk/report): Comprehensive UK postcode area intelligence including safety indices, school ratings, flood risks, and broadband connectivity.
- [Developer Spatial API](https://postcodewise.co.uk/developers/pricing): Metered REST API for developers and enterprises (`GET /api/v1/postcode/{postcode}/intelligence`).
- [Property Environmental Certificates](https://postcodewise.co.uk/services/postcode-intelligence): Official PDF location & safety compliance certificates stamped with secret verification codes for conveyancing and due diligence.
- [SiteScout AI](https://postcodewise.co.uk/discovery/sitescout): Commercial site selection engine calculating demographic purchasing power, footfall proxies, and expansion SWOT analysis.
- [Postcode Comparison Tool](https://postcodewise.co.uk/compare): Side-by-side comparison of any two UK postcodes.

## Model Context Protocol (MCP) Server for AI Agents

Postcodewise provides a native Model Context Protocol (MCP) server for autonomous AI agents, assistants, and LLMs.

- **MCP Endpoint**: https://postcodewise.co.uk/mcp
- **Protocol**: Model Context Protocol (Streamable HTTP POST JSON-RPC)
- **Authentication**: Required on `/mcp` via `Authorization: Bearer <API_KEY>`, `X-API-Key: <API_KEY>`, or `?key=<API_KEY>` parameter. Obtain keys at https://postcodewise.co.uk/settings/api-keys or https://postcodewise.co.uk/developers.
- **Discovery Manifest**: https://postcodewise.co.uk/.well-known/mcp.json
- **Local CLI Handle**: `php artisan mcp:start postcodewise`

### Available MCP Tools

1. `lookup_postcode`
   - **Description**: Inspect any UK postcode for safety score, coordinates, and administrative hierarchy.
   - **Arguments**: `postcode` (string, required) — e.g. "SW1A 1AA", "CV47 2TX"

2. `get_area_metrics`
   - **Description**: Retrieve deep-dive metrics for crime rates, school performance, housing prices, transport, demographics, environment, or connectivity.
   - **Arguments**: `postcode` (string, required), `category` (string, optional: "crime", "schools", "transport", "housing", "demographics", "environment", "connectivity", "all")

3. `lookup_outcode`
   - **Description**: Retrieve aggregated area indicators across an outward code (e.g. SW1A, CV47, M1).
   - **Arguments**: `outcode` (string, required)

4. `search_postcodes`
   - **Description**: Search UK postcodes by town name, ward, or partial string.
   - **Arguments**: `query` (string, required), `limit` (integer, optional)

5. `find_areas`
   - **Description**: Find areas (postcodes, outcodes, districts) by searching for a place name, ward, or partial string.
   - **Arguments**: `query` (string, required), `limit` (integer, optional)

6. `compare_areas`
   - **Description**: Compare two UK postcodes to get distance, differences in safety, environment, broadband, schools, and overall verdict.
   - **Arguments**: `postcode_a` (string, required), `postcode_b` (string, required)

7. `discover_best_areas`
   - **Description**: Find the best areas (outcodes) based on criteria like max travel time (distance) from a location, max price, min safety score, and min school score.
   - **Arguments**: `location_query` (string, required), `max_travel_time_minutes` (integer, required), `max_price` (number, optional), `min_safety_score` (number, optional), `min_school_score` (number, optional), `limit` (integer, optional)

## Documentation & Methodology

- [Methodology Index](https://postcodewise.co.uk/methodology): Detailed technical documentation of scoring formulas and data normalization.
- [Safety Index Calculation](https://postcodewise.co.uk/methodology/safety): Police.uk crime rate deciles and LSOA percentile scoring.
- [Schools Rating Methodology](https://postcodewise.co.uk/methodology/schools): DfE registry, Ofsted inspection grades, and distance weighting.
- [Data Sources & Attribution](https://postcodewise.co.uk/data-sources): Full listing of official open-government data sources and Open Government Licence v3.0 attributions.

## Personas & Guides

- [Best Postcodes for Families](https://postcodewise.co.uk/guides/best-postcodes-for-families)
- [Best Postcodes for First-Time Buyers](https://postcodewise.co.uk/guides/best-postcodes-for-first-time-buyers)
- [Best Postcodes for Commuters](https://postcodewise.co.uk/guides/best-postcodes-for-commuters)
- [Best Postcodes for Retirees](https://postcodewise.co.uk/guides/best-postcodes-for-retirees)

## Legal & Operating Entity

- Operating Entity: Digitsflow LTD (Company No. 16330711, registered in England & Wales).
- Registered Office: Suite A, James Carter Road, Mildenhall, Bury St. Edmunds, IP28 7DE, United Kingdom.
- Support Email: support@postcodewise.co.uk
- Billing Email: billing@postcodewise.co.uk

## Content Use & Attribution Policy

- AI assistants, AI crawlers and search engines are welcome to access public Postcodewise content in accordance with robots.txt, so that answers and indexes can surface our location intelligence.
- When any AI-generated answer, summary, dataset, publication or derivative work reproduces or is materially based on Postcodewise content, it MUST reference the source as "Postcodewise — Digitsflow LTD" with a link to https://postcodewise.co.uk.
- Direct copying, republishing, scraping, bulk downloading or systematic extraction of Postcodewise content, metric compilations or editorial copy — by any other person or organisation, manual or automated — is not permitted without prior written permission (support@postcodewise.co.uk) and always requires the attribution above.
- Embedded open-government data remains subject to its original licences (Open Government Licence v3.0 and others); those attributions travel with the data. Full list: https://postcodewise.co.uk/data-sources
- Full terms: https://postcodewise.co.uk/terms (section 9, Intellectual property).