@registrum/mcp 1.0.0

package/README.md

@@ -0,0 +1,83 @@
+# Registrum MCP Server
+
+Use UK Companies House data directly inside Claude, Cursor, and any other MCP-compatible AI client.
+
+**5 tools, zero boilerplate.** Search companies, pull structured financials, list directors, and map corporate networks — all from the Registrum API.
+
+---
+
+## Installation
+
+### Claude Desktop
+
+Add to `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "registrum": {
+      "command": "npx",
+      "args": ["-y", "@registrum/mcp"],
+      "env": {
+        "REGISTRUM_API_KEY": "reg_live_..."
+      }
+    }
+  }
+}
+```
+
+Get a free API key at [registrum.co.uk](https://registrum.co.uk) (50 calls/month free).
+
+### Cursor
+
+Add to `.cursor/mcp.json` in your project, or to `~/.cursor/mcp.json` globally — same format as above.
+
+### Smithery
+
+Find this server at [smithery.ai/server/@registrum/mcp](https://smithery.ai/server/@registrum/mcp) and install with one click.
+
+---
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_company` | Search for UK companies by name |
+| `get_company` | Enriched company profile (age, overdue flags, SIC descriptions) |
+| `get_financials` | Structured P&L + balance sheet from iXBRL filings |
+| `get_directors` | Directors with full appointment history across all companies |
+| `get_network` | Corporate network via shared director connections |
+
+---
+
+## Example prompts
+
+> "Who are the directors of Tesco PLC and what other companies are they associated with?"
+
+> "Get the latest financials for company 00445790"
+
+> "Search for companies named 'Rolls-Royce' and show me their status"
+
+> "Map the director network for Barratt Developments to depth 2"
+
+---
+
+## Plans
+
+| Plan | Price | Calls/month |
+|------|-------|------------|
+| Free | £0 | 50 |
+| Pro | £49/mo | 2,000 |
+| Enterprise | £149/mo | 10,000 |
+
+[See pricing →](https://registrum.co.uk/#pricing)
+
+---
+
+## API reference
+
+Full API docs at [api.registrum.co.uk/docs](https://api.registrum.co.uk/docs)
+
+## Support
+
+[support@registrum.co.uk](mailto:support@registrum.co.uk)

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+const apiKey = process.env.REGISTRUM_API_KEY;
+if (!apiKey) {
+    process.stderr.write("Error: REGISTRUM_API_KEY environment variable is required.\n" +
+        "Get a free key at https://registrum.co.uk\n");
+    process.exit(1);
+}
+const server = createServer(apiKey);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8DAA8D;QAC9D,6CAA6C,CAC9C,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,5 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const API_BASE = "https://api.registrum.co.uk/v1";
+export declare function callApi(path: string, apiKey: string, baseUrl?: string): Promise<unknown>;
+export declare function createServer(apiKey: string, baseUrl?: string): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,eAAO,MAAM,QAAQ,mCAAmC,CAAC;AAGzD,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,CASlB;AAeD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAAiB,GACzB,SAAS,CA0KX"}

package/dist/server.js

@@ -0,0 +1,163 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+export const API_BASE = "https://api.registrum.co.uk/v1";
+const VERSION = "1.0.0";
+export async function callApi(path, apiKey, baseUrl = API_BASE) {
+    const res = await fetch(`${baseUrl}${path}`, {
+        headers: { "X-API-Key": apiKey },
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`API error ${res.status}: ${body}`);
+    }
+    return res.json();
+}
+function text(content) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(content, null, 2) }],
+    };
+}
+function err(message) {
+    return {
+        isError: true,
+        content: [{ type: "text", text: message }],
+    };
+}
+export function createServer(apiKey, baseUrl = API_BASE) {
+    const api = (path) => callApi(path, apiKey, baseUrl);
+    const server = new McpServer({ name: "registrum", version: VERSION }, {
+        capabilities: { tools: {} },
+        instructions: "Use these tools to look up UK companies registered at Companies House. " +
+            "Company numbers are zero-padded 8-digit strings (e.g. '00445790' for Tesco PLC). " +
+            "When a user gives you a company name, use search_company first to find the number, " +
+            "then use get_company, get_financials, get_directors, or get_network as needed.",
+    });
+    server.registerTool("search_company", {
+        title: "Search for companies",
+        description: "Search for UK companies by name. Returns a list of matching companies with " +
+            "their company number, status, type, and registered address. Use this first " +
+            "when you only have a company name and need its company number.",
+        inputSchema: {
+            query: z.string().min(1).describe("Company name or keywords to search for"),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(20)
+                .optional()
+                .describe("Maximum number of results to return (default 10)"),
+        },
+    }, async ({ query, limit }) => {
+        try {
+            const params = new URLSearchParams({ q: query });
+            if (limit)
+                params.set("limit", String(limit));
+            const data = await api(`/search?${params}`);
+            return text(data);
+        }
+        catch (e) {
+            return err(String(e));
+        }
+    });
+    server.registerTool("get_company", {
+        title: "Get company profile",
+        description: "Get an enriched profile for a UK company by its Companies House number. " +
+            "Returns name, status, type, incorporation date, registered address, SIC codes " +
+            "with descriptions, accounts status, confirmation statement status, and derived " +
+            "fields like company_age_years and accounts.overdue that are not available from " +
+            "the raw Companies House API.",
+        inputSchema: {
+            company_number: z
+                .string()
+                .regex(/^[A-Z0-9]{1,8}$/, "Must be 1–8 alphanumeric characters")
+                .describe("Companies House company number, e.g. '00445790' for Tesco PLC. " +
+                "Numeric-only numbers should be zero-padded to 8 digits."),
+        },
+    }, async ({ company_number }) => {
+        try {
+            const data = await api(`/company/${company_number}`);
+            return text(data);
+        }
+        catch (e) {
+            return err(String(e));
+        }
+    });
+    server.registerTool("get_financials", {
+        title: "Get company financials",
+        description: "Get structured financial data for a UK company, parsed from its iXBRL accounts " +
+            "filed at Companies House. Returns revenue, cost of sales, gross profit, operating " +
+            "profit, net profit, fixed assets, current assets, total equity, net assets, " +
+            "creditors, and average employees for the current and prior reporting year. " +
+            "Also includes accounts type (full/abbreviated/micro/dormant) and a data_quality " +
+            "block indicating which fields were extracted and which were absent from the filing. " +
+            "Cached for 7 days.",
+        inputSchema: {
+            company_number: z
+                .string()
+                .regex(/^[A-Z0-9]{1,8}$/)
+                .describe("Companies House company number, e.g. '00445790' for Tesco PLC"),
+        },
+    }, async ({ company_number }) => {
+        try {
+            const data = await api(`/company/${company_number}/financials`);
+            return text(data);
+        }
+        catch (e) {
+            return err(String(e));
+        }
+    });
+    server.registerTool("get_directors", {
+        title: "Get company directors",
+        description: "Get the current and past directors for a UK company, including each director's " +
+            "name, role, appointment date, resignation date (if applicable), nationality, " +
+            "country of residence, and a list of other companies they serve or have served as " +
+            "director. This gives you a full picture of a director's corporate history in one call.",
+        inputSchema: {
+            company_number: z
+                .string()
+                .regex(/^[A-Z0-9]{1,8}$/)
+                .describe("Companies House company number, e.g. '00445790' for Tesco PLC"),
+        },
+    }, async ({ company_number }) => {
+        try {
+            const data = await api(`/company/${company_number}/directors`);
+            return text(data);
+        }
+        catch (e) {
+            return err(String(e));
+        }
+    });
+    server.registerTool("get_network", {
+        title: "Get director network",
+        description: "Map the corporate network connected to a UK company via shared directors. " +
+            "Returns all companies connected through shared board members, up to the specified " +
+            "depth. Each connected company includes its name, number, status, and the directors " +
+            "it shares with the focal company. Useful for identifying corporate group structures, " +
+            "related party relationships, and director interlocks.",
+        inputSchema: {
+            company_number: z
+                .string()
+                .regex(/^[A-Z0-9]{1,8}$/)
+                .describe("Companies House company number, e.g. '00445790' for Tesco PLC"),
+            depth: z
+                .number()
+                .int()
+                .min(1)
+                .max(2)
+                .optional()
+                .describe("Traversal depth: 1 = direct connections only, 2 = connections of connections (default 1). " +
+                "Depth 2 can return many results for large companies."),
+        },
+    }, async ({ company_number, depth }) => {
+        try {
+            const params = depth ? `?depth=${depth}` : "";
+            const data = await api(`/company/${company_number}/network${params}`);
+            return text(data);
+        }
+        catch (e) {
+            return err(String(e));
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.test.d.ts.map

package/dist/server.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.d.ts","sourceRoot":"","sources":["../src/server.test.ts"],"names":[],"mappings":""}

package/dist/server.test.js

@@ -0,0 +1,187 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
+import { callApi, createServer, API_BASE } from "./server.js";
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function mockFetch(status, body) {
+    vi.spyOn(globalThis, "fetch").mockResolvedValueOnce({
+        ok: status >= 200 && status < 300,
+        status,
+        json: () => Promise.resolve(body),
+        text: () => Promise.resolve(JSON.stringify(body)),
+    });
+}
+async function makeClient() {
+    const server = createServer("reg_test_key", API_BASE);
+    const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+    await server.connect(serverTransport);
+    const client = new Client({ name: "test-client", version: "1.0.0" });
+    await client.connect(clientTransport);
+    return client;
+}
+// ─── callApi ─────────────────────────────────────────────────────────────────
+describe("callApi", () => {
+    beforeEach(() => vi.restoreAllMocks());
+    it("makes a GET request with X-API-Key header and returns parsed JSON", async () => {
+        const spy = vi.spyOn(globalThis, "fetch").mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve({ name: "Tesco PLC" }),
+        });
+        const result = await callApi("/company/00445790", "reg_test_key");
+        expect(result).toEqual({ name: "Tesco PLC" });
+        expect(spy).toHaveBeenCalledWith(`${API_BASE}/company/00445790`, expect.objectContaining({ headers: { "X-API-Key": "reg_test_key" } }));
+    });
+    it("throws an error with status code when response is not ok", async () => {
+        vi.spyOn(globalThis, "fetch").mockResolvedValueOnce({
+            ok: false,
+            status: 401,
+            text: () => Promise.resolve("Unauthorized"),
+        });
+        await expect(callApi("/company/00445790", "bad_key")).rejects.toThrow("API error 401: Unauthorized");
+    });
+    it("throws an error with 404 status for unknown company", async () => {
+        vi.spyOn(globalThis, "fetch").mockResolvedValueOnce({
+            ok: false,
+            status: 404,
+            text: () => Promise.resolve("Not Found"),
+        });
+        await expect(callApi("/company/99999999", "reg_test_key")).rejects.toThrow("API error 404");
+    });
+});
+// ─── search_company ───────────────────────────────────────────────────────────
+describe("search_company tool", () => {
+    beforeEach(() => vi.restoreAllMocks());
+    it("returns company list from the API", async () => {
+        const payload = { results: [{ company_number: "00445790", name: "Tesco PLC" }] };
+        mockFetch(200, payload);
+        const client = await makeClient();
+        const result = await client.callTool({ name: "search_company", arguments: { query: "Tesco" } });
+        expect(result.isError).toBeFalsy();
+        const text = result.content[0].text;
+        expect(JSON.parse(text)).toEqual(payload);
+    });
+    it("includes limit param in the URL when provided", async () => {
+        const spy = vi.spyOn(globalThis, "fetch").mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve({ results: [] }),
+        });
+        const client = await makeClient();
+        await client.callTool({ name: "search_company", arguments: { query: "Tesco", limit: 5 } });
+        const url = spy.mock.calls[0][0];
+        expect(url).toContain("q=Tesco");
+        expect(url).toContain("limit=5");
+    });
+    it("returns isError on API failure", async () => {
+        vi.spyOn(globalThis, "fetch").mockResolvedValueOnce({
+            ok: false,
+            status: 429,
+            text: () => Promise.resolve("Too Many Requests"),
+        });
+        const client = await makeClient();
+        const result = await client.callTool({ name: "search_company", arguments: { query: "Tesco" } });
+        expect(result.isError).toBe(true);
+        const text = result.content[0].text;
+        expect(text).toContain("429");
+    });
+});
+// ─── get_company ──────────────────────────────────────────────────────────────
+describe("get_company tool", () => {
+    beforeEach(() => vi.restoreAllMocks());
+    it("fetches /company/{number} and returns the profile", async () => {
+        const payload = { company_number: "00445790", name: "Tesco PLC" };
+        const spy = vi.spyOn(globalThis, "fetch").mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve(payload),
+        });
+        const client = await makeClient();
+        const result = await client.callTool({
+            name: "get_company",
+            arguments: { company_number: "00445790" },
+        });
+        expect(result.isError).toBeFalsy();
+        const url = spy.mock.calls[0][0];
+        expect(url).toBe(`${API_BASE}/company/00445790`);
+        const text = result.content[0].text;
+        expect(JSON.parse(text)).toEqual(payload);
+    });
+    it("returns isError on 404", async () => {
+        vi.spyOn(globalThis, "fetch").mockResolvedValueOnce({
+            ok: false,
+            status: 404,
+            text: () => Promise.resolve("Not found"),
+        });
+        const client = await makeClient();
+        const result = await client.callTool({
+            name: "get_company",
+            arguments: { company_number: "99999999" },
+        });
+        expect(result.isError).toBe(true);
+    });
+});
+// ─── get_financials ───────────────────────────────────────────────────────────
+describe("get_financials tool", () => {
+    beforeEach(() => vi.restoreAllMocks());
+    it("fetches /company/{number}/financials", async () => {
+        const payload = { revenue: 65000000 };
+        const spy = vi.spyOn(globalThis, "fetch").mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve(payload),
+        });
+        const client = await makeClient();
+        await client.callTool({
+            name: "get_financials",
+            arguments: { company_number: "00445790" },
+        });
+        const url = spy.mock.calls[0][0];
+        expect(url).toBe(`${API_BASE}/company/00445790/financials`);
+    });
+});
+// ─── get_directors ────────────────────────────────────────────────────────────
+describe("get_directors tool", () => {
+    beforeEach(() => vi.restoreAllMocks());
+    it("fetches /company/{number}/directors", async () => {
+        const payload = { directors: [] };
+        const spy = vi.spyOn(globalThis, "fetch").mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve(payload),
+        });
+        const client = await makeClient();
+        await client.callTool({
+            name: "get_directors",
+            arguments: { company_number: "00445790" },
+        });
+        const url = spy.mock.calls[0][0];
+        expect(url).toBe(`${API_BASE}/company/00445790/directors`);
+    });
+});
+// ─── get_network ──────────────────────────────────────────────────────────────
+describe("get_network tool", () => {
+    beforeEach(() => vi.restoreAllMocks());
+    it("fetches /company/{number}/network without depth param by default", async () => {
+        const spy = vi.spyOn(globalThis, "fetch").mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve({ nodes: [] }),
+        });
+        const client = await makeClient();
+        await client.callTool({
+            name: "get_network",
+            arguments: { company_number: "00445790" },
+        });
+        const url = spy.mock.calls[0][0];
+        expect(url).toBe(`${API_BASE}/company/00445790/network`);
+    });
+    it("appends ?depth=2 when depth is provided", async () => {
+        const spy = vi.spyOn(globalThis, "fetch").mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve({ nodes: [] }),
+        });
+        const client = await makeClient();
+        await client.callTool({
+            name: "get_network",
+            arguments: { company_number: "00445790", depth: 2 },
+        });
+        const url = spy.mock.calls[0][0];
+        expect(url).toBe(`${API_BASE}/company/00445790/network?depth=2`);
+    });
+});
+//# sourceMappingURL=server.test.js.map

package/dist/server.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.js","sourceRoot":"","sources":["../src/server.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@registrum/mcp",
+  "version": "1.0.0",
+  "description": "MCP server for the Registrum Companies House API — search UK companies, get financials, directors, and director networks",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "companies-house",
+    "uk-companies",
+    "company-data",
+    "financials",
+    "directors",
+    "registrum"
+  ],
+  "homepage": "https://registrum.co.uk",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eugenemerwe/registrum-mcp"
+  },
+  "license": "MIT",
+  "author": "Eugene Merwe-Chartier",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "registrum-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "typescript": "^5",
+    "vitest": "^3"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}