MCP 服务器

Sirenic

Provides official French and European company data (INSEE Sirene, INPI RNE) for AI agents via pay-per-call USDC on Base, including search, profiles, KYB, sanctions screening, financials, and more.

README

Sirenic Examples

🚀 Sirenic launches on Product Hunt this Wednesday (July 22). Take a look and say hi: https://www.producthunt.com/products/sirenic?launch=sirenic

Working examples for Sirenic — official French and European company data for AI agents. Pay-per-call in USDC via the x402 protocol: no account, no API key — your agent pays each request on Base.

Landing & pricing: https://api.sirenic.eu
OpenAPI: https://api.sirenic.eu/openapi.json
For LLMs: https://api.sirenic.eu/llms.txt
MCP server: https://api.sirenic.eu/mcp (streamable HTTP)

Data sources: INSEE Sirene / INPI RNE and other official registers, open licenses (Etalab 2.0, NLOD, CC-BY 4.0, OGL, CC0). Data is redistributed as published — every response carries source and disclaimer fields.

Quickstart 1 — see a payment quote (no wallet needed)

curl -i "https://api.sirenic.eu/v1/entreprise/552032534" -H "Accept: application/json"

You get HTTP 402 with the x402 payment requirements (price, USDC contract, receiving address, network) in the PAYMENT-REQUIRED header and a JSON body.

Quickstart 2 — pay and call in ~10 lines (TypeScript)

npm install @x402/fetch @x402/core @x402/evm viem

import { privateKeyToAccount } from "viem/accounts";
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";

const account = privateKeyToAccount(process.env.TEST_WALLET_KEY as `0x${string}`);
const client = new x402Client();
registerExactEvmScheme(client, { signer: account });
const payingFetch = wrapFetchWithPayment(fetch, client);

const res = await payingFetch("https://api.sirenic.eu/v1/entreprise/552032534");
console.log(await res.json()); // paid, settled, delivered

TEST_WALLET_KEY is the private key of your client test wallet (the payer). The server never holds any key. The exact scheme uses signed authorizations, so the client pays no gas.

Quickstart 3 — plug into Claude / Cursor (MCP)

Claude Code:

claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

Cursor / any MCP client (mcpServers config):

{ "mcpServers": { "sirenic": { "url": "https://api.sirenic.eu/mcp" } } }

25 tools are exposed (search, company profiles, KYB files, sanctions screening, financials, capital structure, sector benchmarks, failure-risk score…). Each tool accepts an optional x_payment parameter: without it you get the 402 quote; sign it with an x402 client and call again.

Endpoints and prices (USDC per call)

Endpoint	Price	What you get
`GET /v1/recherche?q=`	$0.001	Search 30M French companies
`GET /v1/entreprise/{siren}`	$0.005	Full official French profile
`GET /v1/entreprise/{siren}/etablissements`	$0.003	All establishments (SIRET)
`GET /v1/entreprise/{siren}/alertes`	$0.01	BODACC legal alerts (insolvency…)
`GET /v1/entreprise/{siren}/finances`	$0.01	Filed financials + ratios
`GET /v1/entreprise/{siren}/marches-publics`	$0.01	Public procurement won
`GET /v1/entreprise/{siren}/changements?depuis=`	$0.01	New BODACC events since a date
`GET /v1/entreprise/{siren}/pi`	$0.03	Industrial property (trademarks, patents, designs)
`GET /v1/entreprise/{siren}/comptes-pdf`	$0.15	Accounts annexe notes, AI-extracted (structured)
`GET /v1/entreprise/{siren}/capital`	$0.25	Ownership from public articles, AI-extracted
`GET /v1/entreprise/{siren}/liens-capitalistiques`	$0.15	Single-level capital links between legal entities
`GET /v1/entreprise/{siren}/sante`	$0.15	AI health summary (7-day cache)
`GET /v1/score/defaillance/{siren}`	$0.10	Failure-risk score (deterministic)
`GET /v1/secteur/{code_naf}/benchmarks`	$0.05	Sector aggregates (k-anonymised)
`GET /v1/kyb/{siren}`	$0.15	Full KYB file + sanctions screening
`GET /v1/kyb/batch?sirens=`	$0.105/co	Batch KYB (2–100 companies)
`GET /v1/sanctions/check?name=`	$0.02	5 official sanctions lists, scored
`GET /v1/dirigeant/recherche?nom=`	$0.02	Reverse director search
`GET /v1/prospection?...`	$0.02/page	Multi-criteria prospecting
`GET /v1/rapport/{siren}`	$0.50	PDF report
`GET /v1/entreprise/{siren}/documents`	$0.02	List filed documents (INPI)
`GET /v1/documents/{type}/{id}`	$0.10	Download a filed document (PDF)
`GET /v1/tva/verifier/{numero}`	$0.003	EU VAT validation (VIES)
`GET /v1/eu/recherche?q=`	$0.003	Search European registers + GLEIF
`GET /v1/eu/entreprise/{pays}/{id}`	$0.01	Unified European profile

Free: GET / (landing), GET /preview/entreprise/55203253400646 (sample response), GET /openapi.json, GET /llms.txt, GET /healthz.

In this repo

examples/quote.sh — inspect a 402 quote with curl.
examples/pay-and-call.ts — pay one request end to end.
examples/smoke-test.ts — pay and call every endpoint once (~$1.80 total).
examples/agent-demo.ts — a small autonomous agent that searches, pays and reads profiles.
examples/mcp-setup.md — MCP configuration for Claude, Cursor and generic clients.
tutorial-kyb-agent/ — Build a KYB agent in 20 lines.

Test wallet setup

Create a throwaway wallet (e.g. in MetaMask) and export its private key.
Fund it with a couple of dollars of USDC on Base (any exchange can withdraw to Base network).
export TEST_WALLET_KEY=0x... — never commit it anywhere.

Sirenic settles on Base mainnet.

Disclaimer

Sirenic redistributes official open data as published (Etalab 2.0 and other open licenses). It does not guarantee accuracy or completeness, and outputs (including sanctions screening and AI summaries) are decision aids — not legal, financial or compliance advice.

License: MIT.