Openregistry

Above:an AI agent walks the shareholders ofIceland Foods Ltdthrough 4 UK holding companies —WD FF MIDCO → ICELAND VLNCO → LANNIS → WD FF LIMITED— and surfaces the 8 individuals who actually own the chain (Tarsem Dhaliwal41.35%as the largest shareholder, Walker family51.31%combined). Every share count, every percentage, read verbatim from the registry's own CS01 PDFs.

OpenRegistry is your AI agent's live hotline to 30 national company registries — UK Companies House, France RNE, Germany Handelsregister, Italy InfoCamere (via EU BRIS), Spain BORME, Poland KRS, Korea OpenDART, Canada CBCA, 10 US states, and more.

We return the registry's own response — unmodified.Every field name, every status value, every raw filing byte (XHTML iXBRL / PDF / XBRL) is preserved exactly as the government's system emits it. The identifiers and jurisdiction routing let you reconstruct the government URL for any record. No aggregator markup. No field renames. No document re-rendering. No AI reinterpretation. No stale cache.

Chain queries across borders in a single prompt— a UK Ltd → its Luxembourg SARL → its Cayman LP → the Jersey trust → the individual beneficiary, all in one conversation. Walk ownership structures through 30 jurisdictions to unmask the real person behind any company.

Hosted endpoint:https://openregistry.sophymarine.com/mcp

One-liner.OpenCorporates and BvD areaggregatorsthat re-shape and cache; CH-direct is single-jurisdiction. OpenRegistry is the layer between an AI agent and the original government APIs — verbatim, live, multi-country, no API key for the free tier.

Where OpenRegistry deliberately doesn't have data (statutorily restricted BO registers post-CJEU C-37/20: DE, ES, IT, NL, LU, AT, MT, PT), the response carries a structuredalternative_urlpointing at the AML-obliged-only statutory portal. We don't pretend to have data we don't.

Three full request → response examples for the most common tools. All three reproducible on the free tier. Calls are JSON-RPC over MCP Streamable HTTP athttps://openregistry.sophymarine.com/mcp; for brevity we show the tool name + arguments + the unwrapped response.

3.fetch_document— raw iXBRL annual accounts bytes

// Request — get the document_id from list_filings or get_financials first { "name": "fetch_document", "arguments": { "document_id": "MzQ0MTUyNDU5N2FkaXF6a2N4", "max_bytes": 5000000 } } // Response (metadata + base64-encoded body) { "jurisdiction": "GB", "document_id": "MzQ0MTUyNDU5N2FkaXF6a2N4", "content_type": "application/xhtml+xml", "size_bytes": 348721, "encoding": "base64", "content": "PCFET0NUWVBFIGh0bWwgUFVCTElDIC...", // signed proxy URL for human download / out-of-band fetch "proxy_url": "https://openregistry.sophymarine.com/document/gb/MzQ0MTUyNDU5N2FkaXF6a2N4/content?token=..." }

Thecontentis theliteral iXBRL bytesCompanies House sends — your AI agent parses or re-renders as it sees fit. We don't re-encode, normalise tags, or extract figures into our own schema. Passformat: "png"(Browser Rendering required) to receive a rasterised page-by-page render of scanned PDFs instead.

OpenRegistry surfaces three distinct kinds of failure with structured responses so AI agents can branch on them.

Per-IP for anonymous, per-user for signed-in. The cross-borderfan-out capis a separate counter that limits how manydistinctjurisdictions a caller can hit viasearch_companiesin a rolling 60-second window.

When you exceed either limit, the response is HTTP429:

{ "jsonrpc": "2.0", "error": { "code": -32000, "message": "rate-limited", "data": { "reason": "rate-limited", "retry_after_ms": 12400, "scope": "ip" // or "user" or "fanout" } } }

The HTTP layer also sets the standardRetry-After: 13header (seconds, rounded up).Honourretry_after_msexactly— exponential back-off on top is unnecessary; the limit window is fixed-rolling, not adaptive. Fan-out cap (scope: "fanout") is a 60-second rolling window — the second your oldest country falls off, you can hit a new one. Pro tier caps at 10 distinct countries / 60s, Max at 30, Enterprise unlimited.

Statutorily restricted (CJEU C-37/20 and similar)

Some beneficial-ownership registers became access-restricted to AML-obliged entities post-CJEU C-37/20 (DE, ES, IT, NL, LU, AT, MT, PT) and the Cayman Beneficial Ownership Transparency Act. We don't proxy these — the tool returns HTTP501with structured guidance:

{ "jurisdiction": "DE", "error": "not_proxied_by_design", "reason": "CJEU-C-37-20", "alternative_url": "https://www.transparenzregister.de", "alternative_access": "AML-obliged entities only (banks, lawyers, notaries, etc.)", "human_message": "The German Transparency Register is statutorily gated since 22 Nov 2022." }

This is adesignresponse, not a transient failure — retrying won't help. Thealternative_urlis the canonical statutory portal where qualified entities can register for access.

Upstream errors and tool-level structured 501s

When the upstream registry has its own outage, we surface its error verbatim with a structured wrapper:

{ "jurisdiction": "ES", "error": "upstream_error", "upstream_status": 524, "human_message": "Spain BORME upstream timed out (Madrid bulletin renderer slow). Retry in 30-60s.", "retry_after_ms": 45000 }

Some tools also return501with analternative toolsuggestion when the upstream registry doesn't expose the requested concept (e.g. CZ political parties don't have officers in the standard sense — callsearch_specialised_recordswithsource="rpsh"instead):

{ "error": "alternative_tool_required", "alternative_tool": "search_specialised_records", "alternative_args": { "jurisdiction": "CZ", "source": "rpsh", "...": "..." }, "human_message": "Czech political parties register is exposed via the RPSH sub-source." }

We publish 10 professional Claude Agent Skills for the most common OpenRegistry workflows. Drop them into your Claude Code project's.claude/skills/directory or into any Claude-compatible agent — invoke by intent.

Every skill above is also served by the MCP server as a namedprompt— so any MCP-compatible client (Claude Desktop, Cursor, Cline, Goose, Zed, …) shows them in its prompt picker without installing skill files. Callprompts/listto discover them,prompts/getto invoke. Same names:kyc_cross_border_due_diligence,ubo_cross_border_chain_walker,director_search_pep_screening,live_company_accounts_xbrl,corporate_filing_monitor,global_company_name_availability,industry_competitor_search,shell_company_detector,phoenix_company_radar,sector_gatekeeper_list.

OpenRegistry works with every major MCP-capable client. The samehttps://openregistry.sophymarine.com/mcpendpoint works across all of them.

Settings → Connectors → Add custom connector → pastehttps://openregistry.sophymarine.com/mcp.

For older builds without the Connectors UI, add toclaude_desktop_config.json:

gemini extensions install https://github.com/sophymarine/openregistry

Or add to~/.gemini/settings.jsonmanually (Gemini useshttpUrl, noturl):

{ "mcpServers": { "openregistry": { "httpUrl": "https://openregistry.sophymarine.com/mcp" } } }

Google's consumer Gemini app at gemini.google.com does not support custom MCP today — only the CLI and Gemini Enterprise (Google Cloud admin path) do.

Plus / Pro / Business / Enterprise / Education plans only (Free tier doesn't expose Developer Mode).
- Settings → Apps & Connectors → Advanced settings → enableDeveloper Mode.
- On the Connectors page, clickCreateand pastehttps://openregistry.sophymarine.com/mcp.

{ "mcpServers": { "openregistry": { "url": "https://openregistry.sophymarine.com/mcp" } } }

Or add to.vscode/mcp.json(workspace) or User Settings → MCP. VS Code usesservers(notmcpServers) and requirestype: "http":

{ "servers": { "openregistry": { "type": "http", "url": "https://openregistry.sophymarine.com/mcp" } } }

Microsoft 365 Copilot (Word / Excel / PowerPoint / Teams / Outlook)

Organization-level deployment via Microsoft Copilot Studio agent path. Requires a Microsoft 365 Copilot license.
- InMicrosoft Copilot Studio, open or create an agent →Tools→Add a tool→New tool→Model Context Protocol.
- Pastehttps://openregistry.sophymarine.com/mcp, then forAuthenticationpickOAuth 2.0 → Dynamic discovery(OpenRegistry implements DCR with discovery — zero config).
- Publish the agent and submit it for admin approval. After your Global / Teams Admin approves it in the Microsoft 365 admin center, it appears in theAgent Storeacross Teams, Outlook, Word, Excel, and PowerPoint.

Settings → Cline → MCP Servers → Edit settings → paste intocline_mcp_settings.json:

{ "mcpServers": { "openregistry": { "url": "https://openregistry.sophymarine.com/mcp", "transport": "streamable-http" } } }

Cascade panel → hammer icon (🔨) →Configureopens~/.codeium/windsurf/mcp_config.json. Add this block (note Windsurf usesserverUrl, noturl), then clickRefresh(🔄):

{ "mcpServers": { "openregistry": { "serverUrl": "https://openregistry.sophymarine.com/mcp" } } }

Zed, Goose, Continue, and any other MCP 2025-06-18 client work with the standard config:

{ "mcpServers": { "openregistry": { "url": "https://openregistry.sophymarine.com/mcp" } } }

Every major agent framework ships a generic MCP adapter, so OpenRegistry's 27 tools + 10 prompt workflows plug in with zero framework-specific code. Minimum working example per framework:

All tiers receive the full unmodified upstream data — the only thing Enterprise adds is pre-built source-URL fields for audit-trail convenience.

Every response preserves the upstream registry's identifiers so any fact can be verified at the government record:

- jurisdiction+company_id→ reconstruct the government URL (e.g.https://find-and-update.company-information.service.gov.uk/company/09446231)
- document_id→ the government's own filing identifier, resolvable back to their portal
- jurisdiction_data→ the raw upstream object with every field name preserved
- Filing documents (XHTML iXBRL / PDF / XBRL) returned as raw bytes — no re-rendering

Enterprise tier pre-synthesisessource_url/registry_url/registry_name/data_license/alternative_urlinto every response for one-click audit-trail in compliance reports.

- Auth: OAuth 2.1 + PKCE, passwordless email magic links, RFC 7591 Dynamic Client Registration. No pre-shared API keys.
- Privacy: OpenRegistry proxies official public-registry data. Beneficial-ownership registers that became access-restricted post-CJEU C-37/20 (DE, ES, IT, NL, LU, AT, MT, PT) are not proxied — the tool returns501 alternative_urlpointing at the statutory gated portal (AML-obliged entities only). We explicitly flag where AML gates block the ownership chain.
- Rate limits: per-user for authenticated traffic, per-IP for anonymous — plus a per-jurisdiction upstream-protection cap shared across all users, to keep OpenRegistry a good citizen with the registries we depend on.