OpenRegistry documentation

Live, unmodified company-registry data from 27 national governments via a single MCP endpoint. 27 tools, 10 pre-built Claude skills, streamable HTTP transport.

Getting started

OpenRegistry is a Model Context Protocol server. Connect your AI client to the MCP endpoint and sign in for the free tier.

MCP endpoint: https://openregistry.sophymarine.com/mcp
Claude Desktop: Settings → Connectors → Add custom connector → paste the URL above.
Cursor / Claude Code / Cline: add the endpoint under your tool's MCP configuration.
Gemini CLI: gemini extensions install https://github.com/sophymarine/openregistry
Claude Agent Skills: npx skills add sophymarine/openregistry

Free tier: 30 requests/min per user, all tools, all jurisdictions. See pricing for paid tiers.

Tools (27)

Every tool returns live data from the statutory source. The top-level response is unified across countries; registry-specific fields come through verbatim under jurisdiction_data.

Discovery

list_jurisdictions Per-country schema reference + cross-country support-matrix for any tool.
about Server-level info - principles, tool list, data licences, fan-out caps, rate limits.

Search

search_companies Find companies by name or filter - single jurisdiction, or multi-country fan-out with user confirmation.
search_companies_near_point Geospatial search: candidates within a radius of a lat/lng point (where upstream supports it).
count_companies Count-only endpoint (currently IE) - fast totals without fetching candidates.
search_officers Find people by name across a registry - each hit returns an officer_id to pipe into appointments.
search_addresses Resolve free-text addresses to structured registry codes (e.g. CZ RÚIAN kodObce).
search_specialised_records Search non-company registers (FR associations, NZ financial-service providers, etc.).

Company profile

get_company_profile Full structured profile by company ID - unified top fields + verbatim jurisdiction_data.
get_specialised_record One record from a non-company register.
list_establishments Establishment / vestiging units attached to a parent company.
list_actos_inscritos Spanish BORME-style registered-acts list.

Filings & financials

list_filings Filing history with normalised categories + optional document_id round-trip.
get_financials Annual-accounts filings normalised with period_end, document_id, source_url.

Officers, PSC, shareholders, charges

get_officers Directors / secretaries / members / partners - appointed_on + resigned_on + is_active.
get_officer_appointments Every company an officer has been appointed to - the 'follow the person' endpoint.
get_persons_with_significant_control Beneficial-owner (PSC) records - distinct from shareholders.
get_shareholders Registered shareholders with share_count / percent where exposed.
get_charges Debentures / mortgages / liens registered against a company.

Documents

get_document_metadata Available formats / sizes / page count for a specific filing document.
fetch_document Download the raw filed document - PDF / XHTML iXBRL / XML / base64 inline.
get_document_navigation Outline / headings extracted from large PDFs.
search_document Full-text search inside a specific document.
fetch_document_pages Page-range fetch for large PDFs - avoids exceeding the client's context window.

Utility

check_name_availability Authoritative name-availability check where upstream supports one (currently IM).
list_change_batches Recent change / update batches a registry has published.
get_code_description Registry code lookup (CZ pravniForma, CH legalFormId, etc.).

Claude Agent Skills (10)

Pre-built workflows for common due-diligence tasks. Install with npx skills add sophymarine/openregistry, or clone individual SKILL.md files from the repo.

KYC cross-border due diligence - End-to-end KYB workflow - directors, PSC, filings, risk flags across jurisdictions. · skill source
UBO cross-border chain walker - Walk ownership chains up through holding companies, stop at the natural person. · skill source
Director search + screening - Find everyone a named person has been a director of; flag serial dissolutions. · skill source
Live company accounts (XBRL) - Retrieve annual accounts as filed, parse iXBRL key figures. · skill source
Corporate filing monitor - Poll list_filings on a watchlist of companies; surface new filings. · skill source
Name availability (multi-JS) - Check if a proposed company name is free to register across N jurisdictions. · skill source
Industry competitor search - Enumerate companies by SIC / NACE / TOL industry code. · skill source
Shell-company detector - 10 live signals scored 0–100 - nominee directors, zero accounts, shared addresses. · skill source
Phoenix-company radar - Detect dissolved company → new company at same address + same director. · skill source
Sector gatekeeper list - Regulated-sector officer tracking (UK FCA, DE BaFin firms). · skill source

Agent framework integrations

OpenRegistry is a standards-compliant MCP server, so every major AI agent framework can use it out of the box. Pick your stack for a working code sample:

MCP directory listings

Glama MCP Connectors - one-click install via gateway.
Official MCP Registry - published as io.github.sophymarine/openregistry.
Gemini CLI Extensions - auto-indexed.
Cursor Directory - listed with all 5 skills.
MCP.so.
PulseMCP - weekly crawl.

API

Endpoints exposed by this server

Method	Path	Description
POST	/mcp	MCP 2025-06-18 Streamable HTTP transport.
GET	/.well-known/mcp.json	MCP discovery manifest.
GET	/.well-known/oauth-protected-resource	OAuth 2.0 Protected Resource Metadata (RFC 9728).
GET	/.well-known/oauth-authorization-server	OAuth 2.1 Authorization Server Metadata (RFC 8414).
GET	/.well-known/jwks.json	Public JSON Web Key Set for access-token verification.
POST	/oauth/register	Dynamic Client Registration (RFC 7591) - public clients with PKCE.
GET	/oauth/authorize	OAuth 2.1 authorization endpoint with consent screen.
POST	/oauth/token	Authorization-code + refresh-token grants.
GET	/login	Passwordless magic-link sign-in.
GET	/account	Signed-in account overview and session management.
GET	/account/upgrade	Pick a paid tier - Stripe Checkout handoff.
GET	/healthz	Health check with jurisdiction inventory.
GET	/privacy · /terms	Policies.