Claude Code — .mcp.json in the project root

\n\n```json\n{\n \"mcpServers\": {\n \"registry-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\"registry-mcp\"],\n \"env\": {\n \"REGISTRY_MCP_CONTACT_EMAIL\": \"you@example.com\",\n \"COMPANIES_HOUSE_API_KEY\": \"your-companies-house-key\"\n }\n }\n }\n}\n```\n\nDrop `COMPANIES_HOUSE_API_KEY` if you only need Norway; every other country works without it.\n

\n\n

Cursor — ~/.cursor/mcp.json (or .cursor/mcp.json in the project)

\n\n```json\n{\n \"mcpServers\": {\n \"registry-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\"registry-mcp\"],\n \"env\": { \"REGISTRY_MCP_CONTACT_EMAIL\": \"you@example.com\" }\n }\n }\n}\n```\n

\n\n

Claude Desktop — claude_desktop_config.json

\n\nmacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\nWindows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n \"mcpServers\": {\n \"registry-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\"registry-mcp\"],\n \"env\": { \"REGISTRY_MCP_CONTACT_EMAIL\": \"you@example.com\" }\n }\n }\n}\n```\n

\n\n

npm instead of uvx — same server, Node launcher

\n\n```json\n{\n \"mcpServers\": {\n \"registry-mcp\": { \"command\": \"npx\", \"args\": [\"-y\", \"registry-mcp\"] }\n }\n}\n```\n\n`npx registry-mcp` shells out to `uvx registry-mcp` (falling back to `pipx run registry-mcp`), so Python 3.12+ and one of `uv` or `pipx` must be present.\n

\n\n

Hosted, no local install — Streamable HTTP

\n\n```json\n{\n \"mcpServers\": {\n \"registry-mcp\": { \"type\": \"http\", \"url\": \"https://api.foretak.dev/mcp\" }\n }\n}\n```\n

\n\n**Environment variables** — all optional:\n\n| Variable | Meaning |\n|---|---|\n| `REGISTRY_MCP_CONTACT_EMAIL` | Contact address sent in the `User-Agent` to the national registry, as Brønnøysundregistrene asks of API clients. Unset means an anonymous client, which may be throttled or blocked upstream. |\n| `REGISTRY_MCP_CACHE_PATH` | Path to the local SQLite response cache (24 h TTL). Defaults to `./data/cache.sqlite3`. |\n| `COMPANIES_HOUSE_API_KEY` | Required for the United Kingdom (`GB`). A key is [free and instant](https://developer.company-information.service.gov.uk/get-started). Unset means `GB` lookups return `upstream_error` with a hint naming this variable — every other country keeps working. |\n\n## REST\n\nEvery tool has a REST twin returning the identical JSON document.\n\n```bash\n# One company by organisasjonsnummer\ncurl https://api.foretak.dev/v1/NO/company/923609016\n\n# Search by name\ncurl \"https://api.foretak.dev/v1/NO/search?q=equinor&limit=5\"\n\n# Statutory filing deadlines, from a date you choose\ncurl \"https://api.foretak.dev/v1/NO/company/923609016/deadlines?today=2026-01-15\"\n\n# Checksum-validate an identifier — no upstream call, instant\ncurl https://api.foretak.dev/v1/NO/validate/923609016\n\n# Which countries are live, and which need an API key\ncurl https://api.foretak.dev/v1/countries\n\n# The same five routes for the United Kingdom — GB, never UK\ncurl https://api.foretak.dev/v1/GB/company/00445790\ncurl \"https://api.foretak.dev/v1/GB/search?q=tesco&limit=5\"\ncurl \"https://api.foretak.dev/v1/GB/company/00445790/deadlines?today=2026-09-04\"\ncurl https://api.foretak.dev/v1/GB/validate/445790\n```\n\nMachine-readable docs: [`/llms.txt`](https://api.foretak.dev/llms.txt), [`/llms-full.txt`](https://api.foretak.dev/llms-full.txt), [`/openapi.json`](https://api.foretak.dev/openapi.json).\n\n## Adding your country\n\nNorway is one folder. So is the United Kingdom: [`registries/gb/`](https://github.com/foretak/registry-mcp/blob/main/src/registry_mcp/registries/gb/) was added as four files and one import line, and `GB` appeared in `list_countries`, in every tool, in `/openapi.json` and in `registry://rules/GB` on its own.\n\nCopy `src/registry_mcp/registries/xx/` to `registries//`, implement four methods, add one import line — nothing in `core/` changes, and both surfaces plus the manifests light up for the new country automatically.\n\n**→ [CONTRIBUTING.md](https://github.com/foretak/registry-mcp/blob/main/CONTRIBUTING.md) — \"Add your country\"**, and the [`new country` issue template](https://github.com/foretak/registry-mcp/blob/main/.github/ISSUE_TEMPLATE/new_country.yml) to claim one first.\n\n## Development\n\n```bash\nuv sync --all-extras\nuv run pytest # `-m \"not live\"` to skip the tests that hit the real registry\nuv run mypy .\nuv run ruff check .\n```\n\nLayout:\n\n```\nsrc/registry_mcp/core/ country-neutral models, Registry ABC, rules, date helpers\nsrc/registry_mcp/registries/ one folder per country — no/ (Norway), gb/ (UK), xx/ (template)\nsrc/registry_mcp/api/ FastAPI REST surface\nsrc/registry_mcp/mcp/ FastMCP server (stdio + Streamable HTTP at /mcp)\n```\n\n## Documents\n\n- [`NORBIZ_SPEC.md`](https://github.com/foretak/registry-mcp/blob/main/NORBIZ_SPEC.md) — technical spec of the Norwegian module\n- [`UK_SPEC.md`](https://github.com/foretak/registry-mcp/blob/main/UK_SPEC.md) — technical spec of the UK module\n- [`DECISIONS.md`](https://github.com/foretak/registry-mcp/blob/main/DECISIONS.md) — interface and schema decisions\n- [`KEYWORDS.md`](https://github.com/foretak/registry-mcp/blob/main/KEYWORDS.md) — the canonical alias list\n- [`SUBMISSIONS.md`](https://github.com/foretak/registry-mcp/blob/main/SUBMISSIONS.md) — registry submission status\n- [`legal/terms.md`](https://github.com/foretak/registry-mcp/blob/main/legal/terms.md) — terms of use and data attribution\n\n## Data source and licence\n\nNorwegian data comes from **Enhetsregisteret (Brønnøysundregistrene)**, published under **NLOD 2.0** — attribution required. UK data comes from the **Companies House public register**, Crown copyright, free to re-use with no attribution condition; we cite it anyway. Every response carries `source`, `source_url` and `license` so the attribution travels with the data. This project's own code is MIT licensed. Not affiliated with or endorsed by Brønnøysundregistrene or Companies House.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","upstream",{"_105":106,"_107":108,"_109":110,"_111":112,"_113":114,"_115":116},"requiredSecrets",[],"tags",[96,97,98,99,100,101,102,103,104],"assets",[],"stats",{"_94":58,"_95":58},"ratingAvg","reviewCount","ai-agents","bronnoysund","brreg","business-registry","company-data","enhetsregisteret","norway","organisasjonsnummer","orgnr","topics",[96,97,98,99,100,101,123,124,125,102,103,104],"license","MIT","language","Python","registryName","io.github.foretak/registry-mcp","homepage","https://api.foretak.dev","packages",[117,118],{"_119":122,"_121":21,"_74":75},{"_119":120,"_121":21,"_74":75},"registryType","npm","identifier","pypi","mcp","mcp-server","model-context-protocol","ENV",{"_128":129,"_130":131,"_132":133},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

registry-mcp — national company registries