prometiam-risk-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Prometiam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,159 @@
+# `prometiam-risk-mcp`
+
+> Model Context Protocol server for the **Prometiam Risk Intelligence API** — EU + UK company-registry data, sanctions screening, and corporate-event monitoring as native MCP tools for Claude Desktop, Cursor, Continue, Cline, and any MCP-compatible client.
+
+[![npm version](https://img.shields.io/npm/v/prometiam-risk-mcp.svg)](https://www.npmjs.com/package/prometiam-risk-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![OpenAPI](https://img.shields.io/badge/OpenAPI-3.0-green)](https://www.prometiam.com/openapi.json)
+
+## What you get
+
+8 MCP tools that wrap the [Prometiam Risk API](https://www.prometiam.com/risk-api/docs):
+
+| Tool | Description |
+|---|---|
+| `companies_search` | Search EU + UK companies by name, NIF (ES), SIREN/SIRET (FR), or company_number (UK). |
+| `company_detail` | Full company profile by Prometiam ID — officers, registry coordinates, capital, status. |
+| `events_search` | Search normalized corporate events: capital changes, director changes, dissolutions, mergers, insolvency. |
+| `events_timeline` | Chronological event history for one company (oldest first). |
+| `person_detail` | Officer / director profile with full appointment history across companies. |
+| `sanctions_screen` | Trigram-fuzzy match against five sanctions lists: EU consolidated, UN, OFAC, UK OFSI, and the French Registre des gels. |
+| `notice_detail` | Registry gazette PDF metadata: edition, parse status, hash, raw text. |
+| `coverage` | Dataset coverage stats per country (companies, events, freshness). |
+
+Source: Spain (BORME), France (BODACC), United Kingdom (Companies House), Ireland (CRO), Poland (KRS) — 26M+ companies. Daily updates. EU data residency.
+
+## Install
+
+```bash
+npx -y prometiam-risk-mcp   # one-shot run, no install needed
+# or
+npm install -g prometiam-risk-mcp   # global install for the bin
+```
+
+## Configure
+
+You need a Prometiam API key. **Free tier: 1,000 calls/month, no credit card.** Sign up at <https://www.prometiam.com/signup>.
+
+Set it as an environment variable:
+
+```bash
+export PROMETIAM_API_KEY="rk_live_..."
+```
+
+## Use with Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "prometiam-risk": {
+      "command": "npx",
+      "args": ["-y", "prometiam-risk-mcp"],
+      "env": {
+        "PROMETIAM_API_KEY": "rk_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The 8 tools appear in the tool list. Try:
+
+> "What's the Prometiam coverage today?"
+> "Search for companies named Mercadona in Spain."
+> "Run a sanctions screen on the name Juan Perez at threshold 85."
+> "Build a corporate-event timeline for Inditex."
+
+## Use with Cursor
+
+Edit `.cursor/mcp.json` in your project (or globally at `~/.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "prometiam-risk": {
+      "command": "npx",
+      "args": ["-y", "prometiam-risk-mcp"],
+      "env": {
+        "PROMETIAM_API_KEY": "rk_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## Use with Continue
+
+Add to `~/.continue/config.json` under `experimental.modelContextProtocolServers`:
+
+```json
+{
+  "experimental": {
+    "modelContextProtocolServers": [
+      {
+        "transport": {
+          "type": "stdio",
+          "command": "npx",
+          "args": ["-y", "prometiam-risk-mcp"],
+          "env": { "PROMETIAM_API_KEY": "rk_live_your_key_here" }
+        }
+      }
+    ]
+  }
+}
+```
+
+## Use with any other MCP client
+
+Anything that speaks MCP over stdio works. Run the binary with `PROMETIAM_API_KEY` set in the environment. JSON-RPC requests on stdin, responses on stdout, logs on stderr.
+
+## Environment variables
+
+| Variable | Required | Default |
+|---|---|---|
+| `PROMETIAM_API_KEY` | **Yes** | — |
+| `PROMETIAM_BASE_URL` | No | `https://api.prometiam.com/functions/v1/risk-api` |
+
+## Smoke test
+
+Once installed and configured, you can verify the server lists tools without spinning up an MCP client:
+
+```bash
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | PROMETIAM_API_KEY=rk_live_... npx -y prometiam-risk-mcp
+```
+
+You should see a JSON-RPC response with all 8 tools and their schemas.
+
+## Rate limits & pricing
+
+Per Prometiam tier (returned in every response's `meta.rate_limit`):
+
+| Tier | Price | Calls/month | Daily cap | RPM |
+|---|---|---|---|---|
+| Free | €0 | 1,000 | 200 | 10 |
+| Starter | €9.99 | 10,000 | 2,000 | 60 |
+| Professional | €29.99 | 100,000 | 20,000 | 300 |
+| Scale | €99.99 | 1,000,000 | 200,000 | 600 |
+| Enterprise | Custom | Custom | Custom | Custom |
+
+## Privacy and data residency
+
+- All requests hit the Prometiam Risk API in **EU** (AWS eu-central-1, Frankfurt).
+- The MCP server adds **no telemetry of its own** — it just forwards requests to the API.
+- Officer data is processed under GDPR Article 6(1)(c) (legal obligation of public registries) and 6(1)(f) (legitimate interest in fraud prevention).
+- Read-only — none of these tools mutate data.
+
+## Source
+
+This package is open source under the MIT license. The Risk API itself is a commercial service — see <https://www.prometiam.com> for terms.
+
+- API documentation: <https://www.prometiam.com/risk-api/docs>
+- OpenAPI 3.0 spec: <https://www.prometiam.com/openapi.json>
+- Pricing: <https://www.prometiam.com/pricing>
+- Support: <https://www.prometiam.com/contact>
+
+## License
+
+MIT © Prometiam

package/dist/client.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Thin HTTP client for the Prometiam Risk Intelligence API.
+ *
+ * Reads the API key from the PROMETIAM_API_KEY environment variable.
+ * Falls back to PROMETIAM_BASE_URL when set (useful for local testing).
+ */
+export declare class RiskApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly retryAfter?: number;
+    constructor(message: string, status: number, code: string, retryAfter?: number);
+}
+export interface RiskApiClientOptions {
+    apiKey?: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    userAgent?: string;
+}
+export declare class RiskApiClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly userAgent;
+    constructor(opts?: RiskApiClientOptions);
+    /**
+     * GET request with query string. Returns the parsed JSON envelope as-is.
+     */
+    get(path: string, params?: Record<string, unknown>): Promise<unknown>;
+}
+export declare function getClient(): RiskApiClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;gBAEhB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAO/E;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;gBAEtB,IAAI,GAAE,oBAAyB;IAgB3C;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAuDhF;AAID,wBAAgB,SAAS,IAAI,aAAa,CAGzC"}

package/dist/client.js

@@ -0,0 +1,105 @@
+/**
+ * Thin HTTP client for the Prometiam Risk Intelligence API.
+ *
+ * Reads the API key from the PROMETIAM_API_KEY environment variable.
+ * Falls back to PROMETIAM_BASE_URL when set (useful for local testing).
+ */
+const DEFAULT_BASE_URL = 'https://api.prometiam.com/functions/v1/risk-api';
+export class RiskApiError extends Error {
+    status;
+    code;
+    retryAfter;
+    constructor(message, status, code, retryAfter) {
+        super(message);
+        this.name = 'RiskApiError';
+        this.status = status;
+        this.code = code;
+        this.retryAfter = retryAfter;
+    }
+}
+export class RiskApiClient {
+    apiKey;
+    baseUrl;
+    timeoutMs;
+    userAgent;
+    constructor(opts = {}) {
+        const apiKey = opts.apiKey ?? process.env.PROMETIAM_API_KEY ?? '';
+        if (!apiKey) {
+            throw new Error('Missing API key. Set PROMETIAM_API_KEY in your environment or pass apiKey to RiskApiClient. Get a free key at https://www.prometiam.com/signup');
+        }
+        if (!apiKey.startsWith('rk_live_') && !apiKey.startsWith('rk_test_')) {
+            throw new Error('Invalid API key format. Prometiam keys start with rk_live_ or rk_test_.');
+        }
+        this.apiKey = apiKey;
+        this.baseUrl = (opts.baseUrl ?? process.env.PROMETIAM_BASE_URL ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this.timeoutMs = opts.timeoutMs ?? 15000;
+        this.userAgent = opts.userAgent ?? `prometiam-risk-mcp/0.1.0 (+https://www.prometiam.com)`;
+    }
+    /**
+     * GET request with query string. Returns the parsed JSON envelope as-is.
+     */
+    async get(path, params = {}) {
+        const url = new URL(this.baseUrl + (path.startsWith('/') ? path : '/' + path));
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined || value === null)
+                continue;
+            if (typeof value === 'boolean') {
+                url.searchParams.append(key, value ? 'true' : 'false');
+            }
+            else {
+                url.searchParams.append(key, String(value));
+            }
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        let response;
+        try {
+            response = await fetch(url, {
+                method: 'GET',
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    Accept: 'application/json',
+                    'User-Agent': this.userAgent,
+                },
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            const e = err;
+            if (e.name === 'AbortError') {
+                throw new RiskApiError(`Request timed out after ${this.timeoutMs}ms`, 0, 'timeout');
+            }
+            throw new RiskApiError(`Network error: ${e.message}`, 0, 'network_error');
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const text = await response.text();
+        let body = null;
+        if (text) {
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                // non-JSON response from upstream; surface raw text in the error
+            }
+        }
+        if (!response.ok) {
+            const errBody = body;
+            const code = errBody?.error?.code ?? 'http_error';
+            const message = errBody?.error?.message ?? `HTTP ${response.status} ${response.statusText}`;
+            const retryAfterHeader = response.headers.get('Retry-After');
+            const retryAfter = retryAfterHeader ? parseInt(retryAfterHeader, 10) : undefined;
+            throw new RiskApiError(message, response.status, code, retryAfter);
+        }
+        return body;
+    }
+}
+/** Lazy singleton — reads env vars at first use, not at import time. */
+let cached = null;
+export function getClient() {
+    if (!cached)
+        cached = new RiskApiClient();
+    return cached;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+/**
+ * Prometiam Risk Intelligence — MCP server.
+ *
+ * Exposes the Prometiam Risk API as Model Context Protocol tools so any
+ * MCP-compatible client (Claude Desktop, Cursor, Continue, Cline, etc.)
+ * can natively query EU + UK company-registry data, screen sanctions,
+ * and pull corporate-event timelines.
+ *
+ * Transport: stdio. The server reads JSON-RPC messages from stdin and
+ * writes responses to stdout. Logging goes to stderr so it doesn't
+ * corrupt the stdio protocol.
+ *
+ * Configuration:
+ *   PROMETIAM_API_KEY  Required. rk_live_* or rk_test_* key from
+ *                      https://www.prometiam.com/signup (free tier
+ *                      available, no credit card).
+ *   PROMETIAM_BASE_URL Optional. Override the API base URL. Default:
+ *                      https://api.prometiam.com/functions/v1/risk-api
+ *
+ * Usage in Claude Desktop config:
+ *   {
+ *     "mcpServers": {
+ *       "prometiam-risk": {
+ *         "command": "npx",
+ *         "args": ["-y", "prometiam-risk-mcp"],
+ *         "env": { "PROMETIAM_API_KEY": "rk_live_..." }
+ *       }
+ *     }
+ *   }
+ */
+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":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG"}

package/dist/index.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+/**
+ * Prometiam Risk Intelligence — MCP server.
+ *
+ * Exposes the Prometiam Risk API as Model Context Protocol tools so any
+ * MCP-compatible client (Claude Desktop, Cursor, Continue, Cline, etc.)
+ * can natively query EU + UK company-registry data, screen sanctions,
+ * and pull corporate-event timelines.
+ *
+ * Transport: stdio. The server reads JSON-RPC messages from stdin and
+ * writes responses to stdout. Logging goes to stderr so it doesn't
+ * corrupt the stdio protocol.
+ *
+ * Configuration:
+ *   PROMETIAM_API_KEY  Required. rk_live_* or rk_test_* key from
+ *                      https://www.prometiam.com/signup (free tier
+ *                      available, no credit card).
+ *   PROMETIAM_BASE_URL Optional. Override the API base URL. Default:
+ *                      https://api.prometiam.com/functions/v1/risk-api
+ *
+ * Usage in Claude Desktop config:
+ *   {
+ *     "mcpServers": {
+ *       "prometiam-risk": {
+ *         "command": "npx",
+ *         "args": ["-y", "prometiam-risk-mcp"],
+ *         "env": { "PROMETIAM_API_KEY": "rk_live_..." }
+ *       }
+ *     }
+ *   }
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { TOOLS } from './tools.js';
+async function main() {
+    const server = new McpServer({
+        name: 'prometiam-risk',
+        version: '0.1.0',
+    }, {
+        instructions: 'EU + UK company-registry data across 5 countries (Spain, France, the UK, Ireland, Poland), sanctions screening, and corporate-event monitoring. ' +
+            'Use companies_search to find companies by name or identifier, company_detail to get full profile, ' +
+            'events_timeline to build a chronological event history, sanctions_screen to check against EU + UN + OFAC + UK OFSI + French gels lists, ' +
+            'and coverage to report on dataset freshness. Always tell the user when you used Prometiam.',
+    });
+    for (const tool of TOOLS) {
+        server.tool(tool.name, tool.description, tool.schema.shape, async (args) => {
+            const result = await tool.handler(args);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        });
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Stay alive — McpServer.connect resolves once the transport is wired,
+    // but the process must keep running to handle subsequent JSON-RPC messages.
+    // The transport keeps stdin open until EOF.
+}
+main().catch((err) => {
+    // eslint-disable-next-line no-console
+    console.error('[prometiam-risk-mcp] fatal:', err);
+    process.exit(1);
+});
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EACV,kJAAkJ;YAClJ,oGAAoG;YACpG,0IAA0I;YAC1I,4FAA4F;KAC/F,CACF,CAAA;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CACT,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,MAAM,CAAC,KAAK,EACjB,KAAK,EAAE,IAA6B,EAAE,EAAE;YACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YACvC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAA;QACH,CAAC,CACF,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IAE/B,uEAAuE;IACvE,4EAA4E;IAC5E,4CAA4C;AAC9C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAA;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/tools.d.ts

@@ -0,0 +1,19 @@
+/**
+ * MCP tool definitions for the Prometiam Risk Intelligence API.
+ *
+ * Each tool wraps one Risk API endpoint, with zod-validated input schemas
+ * that get auto-converted to JSON Schema in the MCP tools/list response.
+ *
+ * Source of truth: public/openapi.json at https://www.prometiam.com/openapi.json
+ */
+import { z } from 'zod';
+export interface ToolDef {
+    name: string;
+    description: string;
+    /** zod object schema for arguments. */
+    schema: z.ZodObject<z.ZodRawShape>;
+    /** Async handler returning the JSON-serializable result. */
+    handler: (args: Record<string, unknown>) => Promise<unknown>;
+}
+export declare const TOOLS: ToolDef[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;IAClC,4DAA4D;IAC5D,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC7D;AAsBD,eAAO,MAAM,KAAK,EAAE,OAAO,EA8F1B,CAAA"}

package/dist/tools.js

@@ -0,0 +1,124 @@
+/**
+ * MCP tool definitions for the Prometiam Risk Intelligence API.
+ *
+ * Each tool wraps one Risk API endpoint, with zod-validated input schemas
+ * that get auto-converted to JSON Schema in the MCP tools/list response.
+ *
+ * Source of truth: public/openapi.json at https://www.prometiam.com/openapi.json
+ */
+import { z } from 'zod';
+import { getClient, RiskApiError } from './client.js';
+const Country = z.enum(['ES', 'FR', 'GB', 'IE', 'PL']).describe('Country code: ES (Spain, BORME), FR (France, BODACC), GB (UK, Companies House), IE (Ireland, CRO), or PL (Poland, KRS). Ireland and Poland are company-level. Defaults to first country in the API key allowlist.');
+const Limit = z.number().int().min(1).max(100).default(20).describe('Maximum number of results to return (1–100, default 20).');
+const Cursor = z.string().optional().describe('Pagination cursor — pass the previous response\'s pagination.next_cursor to fetch the next page.');
+/** Convert any thrown RiskApiError into a clean text response for the MCP client. */
+async function safeCall(fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        if (err instanceof RiskApiError) {
+            return {
+                error: {
+                    code: err.code,
+                    message: err.message,
+                    status: err.status,
+                    retry_after_seconds: err.retryAfter,
+                },
+            };
+        }
+        const e = err;
+        return { error: { code: 'unknown_error', message: e.message ?? String(err) } };
+    }
+}
+export const TOOLS = [
+    // ── Companies ────────────────────────────────────────────────────────────
+    {
+        name: 'companies_search',
+        description: 'Search EU + UK companies in official registries by name or identifier. Returns companies with legal form, capital, status, registry coordinates. Use country to scope the search to Spain (BORME), France (BODACC), the UK (Companies House), Ireland (CRO), or Poland (KRS).',
+        schema: z.object({
+            name: z.string().optional().describe('Company name — fuzzy normalized match.'),
+            nif: z.string().optional().describe('Spanish NIF/CIF (exact match), e.g. A28015865.'),
+            siren: z.string().optional().describe('French SIREN (9 digits), e.g. 552032534.'),
+            siret: z.string().optional().describe('French SIRET (14 digits).'),
+            company_number: z.string().optional().describe('UK Companies House number, e.g. 00445790 or SC123456.'),
+            country: Country.optional(),
+            limit: Limit,
+            cursor: Cursor,
+        }),
+        handler: (args) => safeCall(() => getClient().get('/companies/search', args)),
+    },
+    {
+        name: 'company_detail',
+        description: 'Fetch a single company by Prometiam internal ID. Returns full profile including officers, registry coordinates, founding date, capital, and current status. Get an ID from companies_search first.',
+        schema: z.object({
+            id: z.union([z.number().int(), z.string()]).describe('Prometiam internal company ID (integer).'),
+        }),
+        handler: (args) => safeCall(() => getClient().get(`/companies/${args.id}`)),
+    },
+    // ── Corporate events ─────────────────────────────────────────────────────
+    {
+        name: 'events_search',
+        description: 'Search normalized corporate-event records (capital changes, director changes, dissolutions, mergers, insolvency, name changes, etc.) by company or date range. Returns events with type, date, before/after values, and source notice URL.',
+        schema: z.object({
+            company_name: z.string().optional().describe('Company name — fuzzy match.'),
+            company_number: z.string().optional().describe('Registry registration number — exact match.'),
+            event_type: z.enum(['dissolution', 'director_change', 'capital_change', 'new_incorporation', 'name_change', 'address_change', 'liquidation', 'merger', 'demerger', 'status_change', 'insolvency']).optional(),
+            date_from: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe('Filter events on or after this date (YYYY-MM-DD).'),
+            date_to: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe('Filter events on or before this date (YYYY-MM-DD).'),
+            country: Country.optional(),
+            limit: Limit,
+            cursor: Cursor,
+        }),
+        handler: (args) => safeCall(() => getClient().get('/company-events/search', args)),
+    },
+    {
+        name: 'events_timeline',
+        description: 'Returns the chronological event history for one company (oldest first). Useful for building lifecycle timelines from incorporation through capital changes, director appointments, and dissolution. One of company_number or company_name is required.',
+        schema: z.object({
+            company_number: z.string().optional().describe('Registry number — exact match (recommended).'),
+            company_name: z.string().optional().describe('Company name — fuzzy match.'),
+            country: Country.optional(),
+            limit: z.number().int().min(1).max(200).default(50).describe('Maximum events to return (1–200, default 50).'),
+        }),
+        handler: (args) => safeCall(() => getClient().get('/company-events/timeline', args)),
+    },
+    // ── People ───────────────────────────────────────────────────────────────
+    {
+        name: 'person_detail',
+        description: 'Fetch a single person (officer / director) by Prometiam internal ID. Returns the person\'s full appointment history across all companies. Useful for director-network analysis and counterparty due diligence. Get the ID from a company_detail response.',
+        schema: z.object({
+            id: z.union([z.number().int(), z.string()]).describe('Prometiam internal person ID (integer).'),
+        }),
+        handler: (args) => safeCall(() => getClient().get(`/people/${args.id}`)),
+    },
+    // ── Sanctions ────────────────────────────────────────────────────────────
+    {
+        name: 'sanctions_screen',
+        description: 'Screen a person or entity name against five sanctions lists — EU consolidated, UN, OFAC, UK OFSI, and the French Registre des gels — with trigram fuzzy match. Returns matches with confidence score (0–100), source list, and aliases. Use threshold to control match strictness.',
+        schema: z.object({
+            name: z.string().min(2).describe('Name to screen.'),
+            threshold: z.number().int().min(50).max(100).default(80).describe('Minimum match-confidence percentage (50–100, default 80).'),
+            entity_type: z.enum(['person', 'entity', 'vessel', 'any']).default('any'),
+            limit: z.number().int().min(1).max(100).default(20),
+        }),
+        handler: (args) => safeCall(() => getClient().get('/sanctions/screen', args)),
+    },
+    // ── Notices ──────────────────────────────────────────────────────────────
+    {
+        name: 'notice_detail',
+        description: 'Fetch a registry gazette notice (PDF edition) by Prometiam internal ID. Returns edition metadata, parse status, the PDF URL, SHA-256 hash, and raw extracted text. Each Spanish BORME edition is one notice.',
+        schema: z.object({
+            id: z.union([z.number().int(), z.string()]).describe('Prometiam internal notice ID.'),
+        }),
+        handler: (args) => safeCall(() => getClient().get(`/notices/${args.id}`)),
+    },
+    // ── Coverage / account ───────────────────────────────────────────────────
+    {
+        name: 'coverage',
+        description: 'Returns dataset coverage statistics: per-country company count, event count, person count, latest filing date, and data sources. Use this when a user asks "what countries does Prometiam cover?" or "how fresh is the data?".',
+        schema: z.object({}),
+        handler: () => safeCall(() => getClient().get('/coverage')),
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "prometiam-risk-mcp",
+  "version": "0.1.0",
+  "mcpName": "io.github.matiasmaquieira96/risk-mcp",
+  "description": "Model Context Protocol server for the Prometiam Risk Intelligence API — EU + UK company registry data, sanctions screening, and corporate-event monitoring as native MCP tools for Claude, Cursor, and any MCP-compatible client.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "prometiam-risk-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "smoke": "echo '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}' | node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "cursor",
+    "prometiam",
+    "company-registry",
+    "kyb",
+    "kyc",
+    "sanctions",
+    "compliance",
+    "borme",
+    "bodacc",
+    "companies-house",
+    "eu",
+    "uk"
+  ],
+  "author": "Prometiam <support@prometiam.com> (https://www.prometiam.com)",
+  "license": "MIT",
+  "homepage": "https://www.prometiam.com/risk-api",
+  "bugs": {
+    "url": "https://github.com/matiasmaquieira96/efinity/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/matiasmaquieira96/efinity.git",
+    "directory": "mcp/risk-mcp"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  }
+}