MCP server

Use OneGoodArea from inside any MCP client.

Score UK areas, ask about signals in plain English, watch portfolios for change, and generate ready-to-read briefs, all without leaving your AI tools. Eleven tools, installed with one key and a config block.

Get an API key See the install

Tools

API key

Steps to install

£0

To install

01 · Install

Two steps, and it is in your client.

One API key and one config edit. Your client spawns the server for you, and the tools appear in your next conversation. No install command, no separate service to run.

01 · Get an API key

Create a key in your dashboard. Keys start with oga_.

02 · Add the server to your client config

Drop the block into your client, restart it, and the eleven tools are ready. Paste your key in place of oga_…

Claude Desktop · claude_desktop_config.json

{
  "mcpServers": {
    "onegoodarea": {
      "command": "npx",
      "args": ["-y", "@oga-mcp/server"],
      "env": {
        "OOGA_API_KEY": "oga_…"
      }
    }
  }
}

Cursor · .cursor/mcp.json

{
  "mcpServers": {
    "onegoodarea": {
      "command": "npx",
      "args": ["-y", "@oga-mcp/server"],
      "env": { "OOGA_API_KEY": "oga_…" }
    }
  }
}

02 · Tools

Eleven tools, grouped by product.

The four products, one ready-made brief, and a couple of quick lookups. Each tool is a plain call your assistant can make on your behalf, and every answer comes straight from the engine.

Scores

A single number for an area, for the decision you are making.

score_postcode

area, preset

Score a UK postcode or place for one of four presets. You get a 0 to 100 score, the categories behind it with a plain reason and a confidence for each, a short summary, recommendations, and the sources.

Try: Score SW1A 1AA for moving.

compare_postcodes

areas, preset

Score up to eight areas side by side for the same preset, sorted best first. If one area cannot be scored, the rest still come back.

Try: Compare M1 1AE, SW4 0LG, and EH1 1BB for business.

Signals

Every public signal for an area, in one consistent shape.

get_area_signals

area

Every signal for an area across all categories, each with its value, where it sits nationally, its confidence and the reason for it, its source, and when it was measured.

Try: Get all signals for M1 1AE.

get_signals_by_category

area, category

The same, narrowed to a single category when you only need one kind of data.

Try: Show me the crime signals for SW1A 1AA.

Intelligence

Ask in plain English, and check the answer.

find_areas

question

Ask a question in plain English. It is turned into a precise query, the database answers it, and you get the answer with the query behind it, so every result can be checked and run again.

Try: Areas under £250k where prices are rising, in England.

find_peers

area, k

The areas most similar to a given one, ranked by how closely they match across the signals they share.

Try: Find 10 areas similar to M1 1AE.

Monitor

Watch a list of areas and catch the moves that matter.

watch_portfolio

name, areas

Start watching a list of areas in one step. Returns the new portfolio and the areas it is tracking.

Try: Watch 'North Manchester' with M1 1AE, M4 5DR, M8 8QR.

get_portfolio_changes

portfolio, threshold

Check a watched portfolio for meaningful change between two months. Returns which areas moved, in which direction, and by how much. Checking never fires your webhooks.

Try: What has changed in my North Manchester portfolio?

Brief

One ready-to-read brief per area, shaped for who is reading it.

area_brief

area, audience

One brief for an area, shaped for a lender, insurer, retailer or investor: the verdict, the factors that matter to that audience, the signals behind them, recommendations, and sources. Every number is real engine output.

Try: Give me a lender brief on SW1A 1AA.

Reference

Quick lookups that never touch your quota.

methodology_for

Every answer is real engine output.

The server is a thin bridge to the same API everything else runs on. It does not make numbers up, and it does not change how the engine works. It just puts the engine within reach of your assistant.

Written by the engine, not the model

Every summary and brief is composed on our side from real engine output, so the assistant reports the numbers rather than inventing them.

Your key, your limits, your version

Each tool call is a real API call under your own key. The same quota, rate limits and pinned engine version apply, exactly as they would anywhere else.

Stamped and reproducible

Every answer carries the engine version that produced it and, for natural-language queries, the exact query behind it, so you can trace and repeat it.

04 · Local development

Point it at your own backend.

Testing against a local API instance? Set a base URL and the server will talk to it instead. Everything else stays the same.

Dev config

{
  "mcpServers": {
    "onegoodarea-dev": {
      "command": "npx",
      "args": ["-y", "@oga-mcp/server"],
      "env": {
        "OOGA_API_KEY": "oga_dev",
        "OOGA_API_BASE": "http://localhost:4000"
      }
    }
  }
}

Questions, requests or trouble getting set up? Email operation@onegoodarea.co.uk.

05 · Plans

The server is free.

There is no separate charge for the MCP server. Tool calls are ordinary API calls, so they draw on your account the same way any other integration does. Current plans live on the pricing page.

See pricing

Bring UK area data into your assistant.

Get a key, paste the config, restart your client. The eleven tools are waiting in your next conversation.

Get an API key Book a call