@registrum/mcp - npm Package Compare versions

Comparing version 2.0.0 to 2.0.1

package.json

 {
   "name": "@registrum/mcp",
   "mcpName": "io.github.vdmeu/registrum-mcp",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "MCP server for the Registrum Companies House API — search UK companies, get financials, directors, beneficial ownership (PSC), and director networks",
@@ -6,0 +6,0 @@ "keywords": [

README.md

@@ -5,10 +5,37 @@ # Registrum MCP Server
 
-One API key. No Companies House developer account, no rate-limit handling, no
-iXBRL parsing. Works in Claude Desktop, Claude Code, Cursor, and any
-MCP-compatible client.
+[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.vdmeu%2Fregistrum--mcp-4F7BFF)](https://registry.modelcontextprotocol.io)
+[![npm](https://img.shields.io/npm/v/@registrum/mcp?color=22D3A0&label=npm)](https://www.npmjs.com/package/@registrum/mcp)
+[![Status](https://img.shields.io/badge/status-live-22D3A0)](https://status.registrum.co.uk)
+[![Docs](https://img.shields.io/badge/API-reference-7A8FAD)](https://api.registrum.co.uk/docs)
 
-```bash
-npx -y @registrum/mcp
+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:
+
 ```
+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.
+
 ---
@@ -23,3 +50,3 @@
 |---|---|
-| Register for a CH developer key, manage OAuth | One `REGISTRUM_API_KEY` |
+| Register for a CH developer key, manage OAuth | Nothing, or one `REGISTRUM_API_KEY` |
 | 600 requests/5min, and you handle the 429s | Server-side throttling on a higher negotiated budget |
@@ -37,4 +64,7 @@ | Accounts arrive as iXBRL documents you must parse | `get_financials` returns turnover, net assets, profit/loss as numbers |
 
-## Install
+## 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`
@@ -55,3 +85,3 @@ **Cursor** — `.cursor/mcp.json` (per project) or `~/.cursor/mcp.json` (global)
 
-[Get a free key](https://registrum.co.uk/?utm_source=mcp&utm_campaign=readme) — 50 calls/month, no card.
+[Get a free key](https://registrum.co.uk/?utm_source=mcp&utm_campaign=readme) — no card.
 
@@ -103,4 +133,4 @@ ---
 
-Free tier is 50 calls/month with every core endpoint. Paid tiers add volume,
-PSC chain traversal and the ECCTA compliance endpoint.
+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.
 
@@ -118,5 +148,7 @@ Prices and quotas are served live from [`GET /v1/plans`](https://api.registrum.co.uk/v1/plans) —
 - Responses are JSON, cached server-side (24h profiles/directors, 7d financials).
-- Every call sends `User-Agent: @registrum/mcp/<version>` so we can see which
-  features developers actually use. No telemetry runs on your machine.
+- 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](https://api.registrum.co.uk/docs) · [Issues](https://github.com/vdmeu/registrum-mcp/issues) · [[e-mail]](mailto:[e-mail])

New alerts

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Fixed alerts

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Improved metrics

Total package byte prevSize

31693

4.91%

Number of lines in readme file

149

27.35%

No dependency changes