New: the hosted MCP server, sign-in without a key, and a Claude plugin · Methodology 1.12.6 is live.Changelog

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. Twelve tools: sign in from Claude or Claude Code, or install with one key and a config block.

Get an API key See the install

Tools

Keys to copy

Steps to connect

£0

To install

01 · Install

Two steps, and it is in your client.

Sign in from your client, or paste one API key into a config block. Point your client at the hosted endpoint, or let it spawn the local package. Either way the tools appear in your next conversation.

01 · Sign in from your client

In Claude or Claude Code, add the hosted endpoint and sign in with your OneGoodArea account. Nothing to copy.

02 · Or use an API key

Create a key in your dashboard (it starts with oga_), send it in a header to the hosted endpoint, or drop the local block into your client. Paste your key in place of oga_…

Claude, on the web and in the apps

Settings, Connectors, Add custom connector. Name it OneGoodArea, paste https://api.onegoodarea.com/mcp, keep the detected defaults and connect. Sign in to OneGoodArea, click Allow access, and the twelve tools are in your next chat, on every device you use Claude on.

Claude Code

Add the endpoint with the command below, then type /mcp, pick onegoodarea and choose Authenticate. Your browser opens the same sign-in; allow access and the terminal reports it connected.

claude mcp add --transport http onegoodarea https://api.onegoodarea.com/mcp

Approving creates an API key named after the app in your account, for example Claude connector. It carries your plan and allowance like any other key, and revoking it from your dashboard disconnects the app. Any client that supports MCP sign-in works the same way from the URL alone.

Hosted · Claude Code · one command

claude mcp add --transport http onegoodarea https://api.onegoodarea.com/mcp --header "Authorization: Bearer oga_…"

Hosted · Cursor · .cursor/mcp.json

{
  "mcpServers": {
    "onegoodarea": {
      "url": "https://api.onegoodarea.com/mcp",
      "headers": { "Authorization": "Bearer oga_…" }
    }
  }
}

A client that cannot sign in sends your API key in a header instead and reaches the same endpoint with nothing to install. Each tool call is metered like a direct API call under your key. ChatGPT follows once the server is listed in the OpenAI apps directory.

Local · Claude Desktop · claude_desktop_config.json

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

Local · Cursor · .cursor/mcp.json

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

Clients that install from the MCP Registry find the server as com.onegoodarea/oga-mcp. Your API key is still the only thing you add. The listing lives in the official MCP Registry.

02 · Tools

Twelve 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.

Places

One input, the permanent place it names.

resolve_place

query

Turn a postcode, place name, official code or place id into the place it names, with an id that survives boundary changes, how it resolved, and whether a postcode is live or retired. A retired postcode still resolves to the neighbourhood it was in, with the month it was retired.

Try: Resolve SE15 5DP.

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, sort

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 the dates it describes. Optionally newest first.

Try: Get all signals for M1 1AE, newest first.

get_signals_by_category

area, category, sort

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

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

Stamped and traceable

Every answer carries the methodology 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 twelve tools are waiting in your next conversation.

Get an API key Book a call