openregistry
OpenRegistry
Unmodified government company records, live. Cross-border ownership chain walker. 27 national registries.
Above: an AI agent walks the shareholders of Iceland Foods Ltd through 4 UK holding companies — WD FF MIDCO → ICELAND VLNCO → LANNIS → WD FF LIMITED — and surfaces the 8 individuals who actually own the chain (Tarsem Dhaliwal 41.35% as the largest shareholder, Walker family 51.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 27 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 27 jurisdictions to unmask the real person behind any company.
Hosted endpoint: https://openregistry.sophymarine.com/mcp
A platform by Sophymarine.
The 6 pillars
1. Live | Every tool call is a real-time query to the upstream government registry API at the moment you ask. |
2. Direct-to-government | No aggregator, no third-party data warehouse, no nightly scrape. Your AI talks to UK Companies House, France INSEE, German Registerportal, Korean FSS OpenDART directly. |
3. Unmodified + source-linked | Every field name, every status code, every raw filing byte returned verbatim. The registry's own identifiers are preserved so any response traces back to the government record. Enterprise tier adds pre-synthesised |
4. Zero-stale | No cache layer we control can ever go stale. You see an update the moment the government records it. Contrast with commercial data providers that serve 6-24 hour-old snapshots. |
5. Stable | Production-grade reliability, running on Cloudflare Workers' global edge + a warm pool of per-jurisdiction workers for stateful registries. |
6. Cross-border | Chain queries across 27 registries in a single prompt. Walk UK Ltd → LU SARL → KY LP → individual without leaving the conversation. |
Related MCP server: Norwegian Business Registry MCP Server
Ready-to-use skills
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.
# | Skill | Outcome in one prompt |
1 | Full statutory dossier: profile + directors + UBO + shareholders + charges + latest accounts | |
2 ⭐ | Walk the ownership chain across jurisdictions until you reach the real individual | |
3 | Every company a person has run + co-director network | |
4 | Latest statutory accounts as machine-readable XBRL / iXBRL / PDF + key figures | |
5 | Material filings in a window, categorised and flagged | |
6 | Is a name free to register across 10+ countries? | |
7 | Every company in a sector across N jurisdictions, ranked + enriched | |
8 | Flag 1-director + no-accounts + overseas-office shells (AML signal) | |
9 | Detect dissolved-then-reborn fraud patterns (same director, same address) | |
10 | Every CIMA / FCA / BaFin / FSS-licensed regulated entity |
See skills/README.md for the skillpack overview.
Same 10 workflows, also as MCP prompts
Every skill above is also served by the MCP server as a named prompt — so any MCP-compatible client (Claude Desktop, Cursor, Cline, Goose, Zed, …) shows them in its prompt picker without installing skill files. Call prompts/list to discover them, prompts/get to 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.
Connect
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"openregistry": {
"url": "https://openregistry.sophymarine.com/mcp",
"transport": "http"
}
}
}Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"openregistry": {
"url": "https://openregistry.sophymarine.com/mcp"
}
}
}Claude Code
claude mcp add --transport http OpenRegistry https://openregistry.sophymarine.com/mcpCline (VS Code)
Settings → Cline → MCP Servers → Add:
{
"openregistry": {
"url": "https://openregistry.sophymarine.com/mcp",
"transport": "streamable-http"
}
}See llms-install.md for automated LLM-driven installs.
Anything else speaking MCP
Streamable HTTP transport per MCP spec 2025-06-18. OAuth 2.1 authorization flow for authenticated tiers (Dynamic Client Registration per RFC 7591 — no API key to paste).
AI agent frameworks (code samples)
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:
LangChain / LangGraph (Python) → openregistry.sophymarine.com/docs/integrations/langchain
LlamaIndex (Python) → /docs/integrations/llamaindex
CrewAI (Python) → /docs/integrations/crewai
Haystack (Python) → /docs/integrations/haystack
AutoGen (Microsoft) (Python) → /docs/integrations/autogen
Vercel AI SDK (TypeScript) → /docs/integrations/vercel-ai-sdk
Tiers
Tier | Price | Rate limit | Cross-border fan-out | Source URLs |
Anonymous | free | 20/min per IP | 3 countries / 60s | identifiers only (URL reconstructable) |
Free (signed in) | free | 30/min per user | 3 countries / 60s | identifiers only |
Pro | $9/mo | 180/min per user | 10 countries / 60s | identifiers only |
Max | $29/mo | 900/min per user | 30 countries / 60s | identifiers only |
Enterprise | contact | 3000/min per user | unlimited |
|
All tiers receive the full unmodified upstream data — the only thing Enterprise adds is pre-built source-URL fields for audit-trail convenience.
Provenance & Auditability
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 portaljurisdiction_data→ the raw upstream object with every field name preservedFiling documents (XHTML iXBRL / PDF / XBRL) returned as raw bytes — no re-rendering
Enterprise tier pre-synthesises source_url / registry_url / registry_name / data_license / alternative_url into every response for one-click audit-trail in compliance reports.
Security and compliance
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 returns
501 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.
Support
Hosted app + account management: openregistry.sophymarine.com/account
Tool capability matrix: call
list_jurisdictionsor visit openregistry.sophymarine.com/jurisdictionsEnterprise inquiries / partnerships: contact@sophymarine.com
Status + uptime: openregistry.sophymarine.com/status
This repo is documentation only. The OpenRegistry service implementation is closed-source; raise issues here for the integration experience (documentation, examples, install flows).
OpenRegistry is a platform by Sophymarine.
© 2026 Sophymarine. OpenRegistry and Sophymarine are trademarks of Sophymarine. Documentation in this repository is published under CC-BY-4.0.
Available Tools
10 toolsfetch_documentFetch documentARead-onlyIdempotentInspect
Read a filing's content by document_id (from list_filings). Filing metadata alone doesn't answer most questions — the numbers and text live inside the document.
RESPONSE SHAPES:
• kind='embedded' (under max_bytes ≈ 20 MB) — returns full bytes_base64, source_url_official (evergreen registry URL), and source_url_direct (short-TTL signed proxy URL). PDFs render as a document block you can read natively.
• kind='resource_link' (oversized) — NO bytes_base64. Returns reason, next_steps, both source URLs, and index_preview {page_count, text_layer, outline_present}. Use get_document_navigation to locate pages, then re-call this tool with pages='N-M' and format='pdf'|'text'|'png' for the content.
CRITICAL: if this tool fails (rate limit, 5xx, timeout), do NOT fill in names / numbers / dates from memory — tell the user what failed and offer retry or source_url_official. Outline titles, previews, and snippets from navigation tools are for LOCATING pages, never for quoting.
source_url_official is auto-resolved from the most recent list_filings call; the optional company_id / transaction_id / filing_type / filing_description inputs are overrides for the rare case where document_id didn't come through list_filings.
Inputs: jurisdiction (required), document_id (required), format, max_bytes, +5 more. Returns: queried_at, jurisdiction, document_id, source_url, +6 more
get_company_profileCompany profileARead-onlyIdempotentInspect
Fetch the structured profile of a company by its registry-specific ID. Returns unified top-level fields (company_id, company_name, status, status_detail, incorporation_date, registered_address) plus raw upstream fields under jurisdiction_data. status is a coarse active/inactive/dissolved/unknown enum; status_detail keeps the registry's native string. registered_address is a flat string; the upstream nested form (when present) stays in jurisdiction_data.
Does not bundle officers / shareholders / filings / charges — call those tools separately. ID format varies per registry; pull company_id from search_companies rather than guessing. For per-country ID format and the full jurisdiction_data field catalogue call list_jurisdictions({jurisdiction:'<CC>'}).
Inputs: jurisdiction (required), company_id (required), include, fresh. Returns: queried_at, jurisdiction, company_id, company_name, +5 more
get_document_metadataDocument metadataARead-onlyIdempotentInspect
Retrieve metadata for a filing document by document_id (from list_filings). Returns available content formats with byte sizes, page count, source URL, creation date. Raw upstream fields preserved under jurisdiction_data. Call this before fetch_document when a document may be large or its format is unknown.
Do NOT construct or guess document_id — some registries use composite IDs that must come from list_filings. Synthesized IDs will 404. Empty available_formats means the body is paywalled or unavailable upstream. Unsupported jurisdictions return 501.
Inputs: jurisdiction (required), document_id (required), fresh. Returns: queried_at, jurisdiction, document_id, source_url, +4 more
get_officersOfficersARead-onlyIdempotentInspect
Return a company's officers — current directors, secretaries, members, partners, board members, procurists, liquidators, plus historical resignations by default. Each officer has a unified shape (officer_id, name, role, appointed_on, resigned_on, is_active) plus raw upstream fields in jurisdiction_data. Role labels pass through in the registry's native language (e.g. Styremedlem, Předseda představenstva, Président); translate client-side. Birth-date precision varies by registry.
Officer-ID stability varies: corporate officers usually carry the corporate's own company_id; natural persons may carry a synthetic index. Some registries mask names under GDPR — that masking is upstream. Jurisdictions without an officer feed return 501.
Inputs: jurisdiction (required), company_id (required), include_resigned, group_by_person, +1 more. Returns: queried_at, officers, items, data, +2 more
list_filingsFiling historyARead-onlyIdempotentInspect
Return a company's filing history, newest first. Each filing has filing_id, filing_date, category, description, and (when upstream exposes one) a document_id that round-trips to get_document_metadata / fetch_document. Raw upstream fields preserved under jurisdiction_data.
Filter via the optional category. Common normalized values: 'accounts', 'annual-return', 'capital', 'charges', 'confirmation-statement', 'incorporation', 'insolvency', 'liquidation', 'mortgage', 'officers', 'resolution'. Native upstream form codes also accepted.
This tool returns metadata only — call fetch_document on document_id for the actual filing bytes. has_document=false means the body is paywalled or unavailable upstream. Pagination uses limit (default 25, max 1000) plus cursor (GB) or offset (IE). Unsupported jurisdictions return 501; call list_jurisdictions for per-country category values and pagination style.
Inputs: jurisdiction (required), company_id (required), category, limit, +3 more. Returns: queried_at, items, total_count, next_cursor
list_jurisdictionsCountry and tool matrixARead-onlyIdempotentInspect
Per-country reference. Pass EXACTLY ONE of:
• jurisdiction='GB' — registry name + URL, data license, company-ID format with examples, native-to-unified status enum mapping, and the list of tools supported.
• supports_tool='get_officers' — which jurisdictions implement a given tool.
Inputs: jurisdiction, supports_tool. Returns: queried_at, jurisdiction, tool, supported_count, +4 more
search_companiesSearch companiesARead-onlyIdempotentInspect
Search a national company registry by name or keyword. Pass EXACTLY ONE of:
• jurisdiction='GB' - single country, direct.
• jurisdictions=['GB','NO','FR'] - multi-country when you're unsure; the server asks the user to confirm (clients with MCP elicitation) or errors back asking you to ask in chat. Per-tier cap on distinct countries per call: anonymous=3, pro=10, max=30, enterprise=unlimited.
Returns candidates with unified fields (company_id, company_name, status, incorporation_date, registered_address) plus raw upstream jurisdiction_data. For country-specific filters (FR ca_min, CZ czNace, CH canton, etc.) pass the filters object — call list_jurisdictions for the per-country schema.
Inputs: jurisdiction, jurisdictions, query, limit, +3 more. Returns: queried_at, jurisdiction, jurisdictions, query, +6 more
search_officersSearch officers by nameARead-onlyIdempotentInspect
Find people holding or who held officer positions (director, secretary, member, partner) in a jurisdiction's registry by name. Returns candidates with officer_id, name, and (where exposed) appointment count. Entry point for person-centric investigations.
Inputs: jurisdiction (required), query (required), limit. Returns: queried_at, jurisdiction, query, count, +2 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a uniquely defined purpose: filings, documents, company profile, officers, shareholders, jurisdictions, and search. No overlap in functionality; descriptions clearly differentiate their roles.
All tool names follow a consistent verb_noun pattern (e.g., fetch_document, get_company_profile, list_filings) using lowercase snake_case throughout, ensuring predictability.
With 10 tools covering search, retrieval, metadata, navigation, and reference for company registry data, the count is well-scoped and appropriate for the domain.
The tool set covers the full read lifecycle: searching companies, listing filings, fetching documents with metadata and navigation, and retrieving officers and shareholders. Gaps like beneficial owners are acknowledged as separate, making the surface complete for its purpose.
Maintenance
Related MCP Connectors
UBO, sanctions & ownership graph. 23 tools, 130.7M entities, 31 registries.
No sign-up. UK companies, PSC/beneficial owners, KYB: Companies House, Sirene, LEI, insolvency.
KYB data from 23 European business registries — company briefs, financials, ownership, AML screening
Global B2B intelligence for AI agents: 35M+ companies, 1.6M sanctions, KYB pack. 78 tools.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables mapping JavaScript error stack traces back to original source code, extracting context information to help developers locate and fix issues.32MIT
- AlicenseBqualityDmaintenanceEnables comprehensive access to the Norwegian Business Registry API for querying company information, board members, subsidiaries, organizational data, and voluntary organizations. Provides real-time access to over 1 million registered Norwegian entities with detailed corporate structure and governance data.158MIT
- AlicenseAqualityDmaintenanceProvides access to a suite of Nordic data tools covering Danish business records, addresses, weather, and energy prices, alongside Norwegian and Finnish company information. This unified server enables users to query public APIs for regional data across Denmark, Norway, and Finland without requiring individual API keys.332MIT
- FlicenseBqualityDmaintenanceAn MCP adapter that maps Coffee Company B2B HTTP APIs to MCP tools, allowing AI agents to query member information, benefits, coupons, and payment statuses. It enables seamless integration for AI assistants to manage coffee-related customer assets and loyalty details through natural language.101-