io.github.vdmeu/registrum-mcp

编码与调试

by vdmeu

通过 Registrum Companies House API 查询英国公司,获取财务、董事及关联网络信息。

什么是 io.github.vdmeu/registrum-mcp

通过 Registrum Companies House API 查询英国公司,获取财务、董事及关联网络信息。

README

Registrum MCP Server

UK company data in your AI agent — without building Companies House plumbing.

MCP Registry npm Status Docs

No Companies House developer account, no rate-limit handling, no iXBRL parsing. Works in Claude Desktop, Claude Code, Cursor, and any MCP-compatible client.

Try it now — no signup, no key, no install

Point your client at the hosted endpoint and every tool answers with real data:

code
https://registrum.co.uk/api/mcp
json
{
  "mcpServers": {
    "registrum": {
      "url": "https://registrum.co.uk/api/mcp"
    }
  }
}

That is the whole setup. Ask it "Who ultimately owns Rolls-Royce Holdings?" and it will trace the ownership chain.

The free anonymous tier is generous on the everyday tools and deliberately small on the expensive ones — a couple of ownership-chain traces and financial statements per day, which is enough to see exactly what comes back before you decide anything. When you reach a cap, the tool tells you so and points at a free key; nothing silently degrades.


Why this instead of the Companies House API directly

Companies House publishes the raw register for free, and you can absolutely call it yourself. What you then own is the plumbing:

Doing it yourselfWith Registrum
Register for a CH developer key, manage OAuthNothing, or one REGISTRUM_API_KEY
600 requests/5min, and you handle the 429sServer-side throttling on a higher negotiated budget
Accounts arrive as iXBRL documents you must parseget_financials returns turnover, net assets, profit/loss as numbers
PSC control types are raw codesDecoded to plain English
Ownership chains: recurse yourself, handle cyclesget_psc_chain returns the resolved tree with termination reasons
Director networks: N+1 queries across appointmentsget_network traverses to depth 2
Retry, cache, and survive CH outages yourself24h/7d caching, circuit breaker, stale-while-revalidate

Other Companies House MCP servers make you bring your own CH key and hand back the raw response. This one does the enrichment.


Running it with your own key

Use a key when you want the anonymous caps lifted, or when you would rather run the server locally than call ours.

Claude Desktop~/.claude/claude_desktop_config.json Cursor.cursor/mcp.json (per project) or ~/.cursor/mcp.json (global)

json
{
  "mcpServers": {
    "registrum": {
      "command": "npx",
      "args": ["-y", "@registrum/mcp"],
      "env": { "REGISTRUM_API_KEY": "reg_live_..." }
    }
  }
}

Get a free key — no card.


Tools

ToolWhat you get
search_companyFind a company by name → company number
get_bundleProfile, compliance, financials, PSCs and directors in one call - start here
get_companyProfile: status, age, SIC descriptions, overdue flags
get_financialsTurnover, net assets, profit/loss, employees — parsed from iXBRL, in GBP
get_directorsCurrent board with appointment history across all their companies
get_pscPersons with Significant Control, control types in plain English
get_psc_chainOwnership traversed to ultimate beneficial owners, with termination reasons
get_complianceECCTA identity-verification status — who has verified, who is pending, who is overdue
get_networkCompanies connected by shared directors, to depth 2

On get_bundle

Most questions about a company need several of these views at once. get_bundle returns them in a single request: one call and one credit instead of five, and one round trip instead of five. Pass include to fetch a subset, or omit it for all five sections.

Each section carries exactly what its own endpoint returns, because the bundle is composed from those same handlers rather than reimplemented - so plan gates, caching and the ECCTA rules behave identically either way.

A null section is not an error. Financials come back null for a company that has filed no machine-readable accounts, and compliance requires a Pro plan. Only a missing company is an error, and that is a 404. Report a null section as "not available", never as an absence of the underlying fact.

On get_compliance

The Economic Crime and Corporate Transparency Act requires every UK director and PSC to verify their identity with Companies House. Enforcement begins 18 November 2026, after which unverified officers can block filings.

The tool returns verified / pending / overdue counts plus each unverified person and their individual deadline. It deliberately distinguishes pending (deadline not yet reached — not a failure) from overdue (missed). Treating those as the same thing is the single easiest way to report a compliant company as non-compliant.


Example prompts

"Is Tesco PLC compliant with ECCTA director verification, and who still needs to verify?"

"Pull the last filed financials for 00445790 and tell me if turnover grew."

"Who ultimately owns Rolls-Royce Holdings? Trace the ownership chain."

"Which companies share directors with Barratt Developments?"

"Search for 'Monzo' and show me status, incorporation date and directors."


Plans

The anonymous endpoint needs no account at all. A free key raises the caps, and paid tiers add volume, PSC chain traversal and the ECCTA compliance endpoint.

Prices and quotas are served live from GET /v1/plans — that endpoint is the source of truth, so this README does not duplicate the numbers and cannot go stale against them. Human-readable version at registrum.co.uk.


Notes

  • Company numbers are zero-padded 8-character strings: 00445790, SC000268.
  • Responses are JSON, cached server-side (24h profiles/directors, 7d financials).
  • The hosted endpoint is stateless and anonymous: it stores no account, and rate limiting is keyed on a hash of the calling IP rather than anything about you.
  • The npm package sends User-Agent: @registrum/mcp/<version> so we can see which features developers actually use. No telemetry runs on your machine.

API reference · Issues · support@registrum.co.uk

常见问题

io.github.vdmeu/registrum-mcp 是什么?

通过 Registrum Companies House API 查询英国公司,获取财务、董事及关联网络信息。

相关 Skills

网页构建器

by anthropics

Universal
热门

面向复杂 claude.ai HTML artifact 开发,快速初始化 React + Tailwind CSS + shadcn/ui 项目并打包为单文件 HTML,适合需要状态管理、路由或多组件交互的页面。

在 claude.ai 里做复杂网页 Artifact 很省心,多组件、状态和路由都能顺手搭起来,React、Tailwind 与 shadcn/ui 组合效率高、成品也更精致。

编码与调试
未扫描176.4k

网页应用测试

by anthropics

Universal
热门

用 Playwright 为本地 Web 应用编写自动化测试,支持启动开发服务器、校验前端交互、排查 UI 异常、抓取截图与浏览器日志,适合调试动态页面和回归验证。

借助 Playwright 一站式验证本地 Web 应用前端功能,调 UI 时还能同步查看日志和截图,定位问题更快。

编码与调试
未扫描176.4k

前端设计

by anthropics

Universal
热门

面向组件、页面、海报和 Web 应用开发,按鲜明视觉方向生成可直接落地的前端代码与高质感 UI,适合做 landing page、Dashboard 或美化现有界面,避开千篇一律的 AI 审美。

想把页面做得既能上线又有设计感,就用前端设计:组件到整站都能产出,难得的是能避开千篇一律的 AI 味。

编码与调试
未扫描176.4k

相关 MCP Server

GitHub

编辑精选

by GitHub

热门

GitHub 是 MCP 官方参考服务器,让 Claude 直接读写你的代码仓库和 Issues。

这个参考服务器解决了开发者想让 AI 安全访问 GitHub 数据的问题,适合需要自动化代码审查或 Issue 管理的团队。但注意它只是参考实现,生产环境得自己加固安全。

编码与调试
89.7k

by Context7

热门

Context7 是实时拉取最新文档和代码示例的智能助手,让你告别过时资料。

它能解决开发者查找文档时信息滞后的问题,特别适合快速上手新库或跟进更新。不过,依赖外部源可能导致偶尔的数据延迟,建议结合官方文档使用。

编码与调试
60.2k

by tldraw

热门

tldraw 是让 AI 助手直接在无限画布上绘图和协作的 MCP 服务器。

这解决了 AI 只能输出文本、无法视觉化协作的痛点——想象让 Claude 帮你画流程图或白板讨论。最适合需要快速原型设计或头脑风暴的开发者。不过,目前它只是个基础连接器,你得自己搭建画布应用才能发挥全部潜力。

编码与调试
49.9k

评论