Skip to main content
Glama
Sirenic MCP server

Sirenic MCP server

Official
README.md
# Sirenic MCP server

![Claude Code, with this server installed from npm, builds a prospecting list, checks the first company and pays both calls in x402](media/demo.gif)

**Who should we prospect in France, and can we work with this client?** Ask your agent. With this server it
[builds the list from the official French register](https://api.sirenic.eu/en/use-cases/build-b2b-prospecting-list-from-official-french-registry)
(activity code, area, legal form, workforce, age, certifications), then checks the company you are about to sign:
registers of France and Europe, officers, legal notices, VAT number and sanctions lists, with a citation of the
register it read.
Each call is paid on its own: with a free API key, or in USDC from a local x402 wallet, without an account.

`sirenic-mcp` is a local [Model Context Protocol](https://modelcontextprotocol.io) server (stdio) for Claude
Desktop, Cursor, Claude Code and any MCP client that starts a local server. It serves the same tools as the hosted
Sirenic server (`https://api.sirenic.eu/mcp`) and pays for them on your behalf, within caps you set.

## Install

Nothing to clone. In your client's MCP configuration (`claude_desktop_config.json` for Claude Desktop,
`~/.cursor/mcp.json` for Cursor):

```json
{
  "mcpServers": {
    "sirenic": {
      "command": "npx",
      "args": ["-y", "sirenic-mcp"],
      "env": { "SIRENIC_API_KEY": "srn_live_..." }
    }
  }
}
```

Claude Code, in one line:

```bash
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp
```

Node.js 22 or later. Then ask, for example: *"List active software companies (NAF 62.01Z) in the Rhône department
with 10 to 49 employees, then check the first one before we contact them."*

Prefer a remote server? Clients that speak streamable HTTP can use `https://api.sirenic.eu/mcp` directly (each
tool takes an `x_payment` argument), or the OAuth connector `https://api.sirenic.eu/mcp/connecteur`: see
[api.sirenic.eu/en/connectors](https://api.sirenic.eu/en/connectors).

## Two ways to pay

| Rail | Set | What happens |
|---|---|---|
| API key | `SIRENIC_API_KEY` | Calls go to `https://api.sirenic.eu/mcp/connecteur` with `Authorization: Bearer <key>`. A free key gives 150 calls a month on routes at $0.05 or less; beyond, prepaid credits are charged at the same prices. [Get a key](https://api.sirenic.eu/compte?utm_source=forge&utm_campaign=sirenic-mcp-npm). |
| x402 wallet | `SIRENIC_WALLET_KEY` | No account. When a tool returns its price (an x402 quote), the local wallet signs a USDC payment on Base (an EIP-3009 authorization: no gas) and the call is sent again with it. The server settles, then answers. |

When both are set, the API key pays and the wallet is never used. When neither is set, tools are listed and a paid
call returns its price and how to pay, without paying.

The wallet's private key stays in memory: it is never written to disk, logged or sent anywhere. Use a dedicated
wallet holding only what you are ready to spend.

## Caps (x402 rail)

| Variable | English alias | Default | Meaning |
|---|---|---|---|
| `SIRENIC_MAX_PAR_APPEL` | `SIRENIC_MAX_PER_CALL` | `0.05` | The most a single call may cost, in USD. |
| `SIRENIC_MAX_PAR_SESSION` | `SIRENIC_MAX_PER_SESSION` | `0.50` | The most the server process may spend, in USD. |

A quote above a cap is refused before anything is signed. The tool answers `plafond_depasse` with the quoted price,
the cap and the variable to raise; the tool list itself is unchanged (tools above the cap stay listed). Most tools
cost $0.05 or less. The session cap counts the calls in progress too: a price is held against it before the
signature, so calls sent together never spend more than the cap.

## How it works

- At startup the server reads the tool list of `https://api.sirenic.eu/mcp` (`tools/list`): names, descriptions,
  schemas, and each tool's routes and prices in `_meta["eu.sirenic/prix"]` (with the maximum and the rule when the
  price depends on a parameter: a watch's duration, a file's blocks). Nothing is written by hand in this package.
  It removes the two payment arguments (`x_payment`, `api_key`): the model never handles a key or a signature.
- Each call is forwarded to the Sirenic server. The paywall stays on the server: this package never calls a REST
  route, never builds a quote and only signs a quote the server returned, under your caps.
- A call paid in x402 and settled returns the server's settlement receipt in `_meta["x402/payment-response"]`
  (transaction, network, payer). A payment that is not settled returns none, and this package never makes one up.
- If the server cannot be reached at startup, the tool list comes from the snapshot shipped with the package (its
  date is in the server instructions) and every call is refused until the server answers. Nothing is signed.
- No file is written, no telemetry is sent. The server identifies itself as `sirenic-mcp-npm/<version>`.

Without a rail, a paid tool is not an error: it answers `payment_required: true` in `structuredContent`, with the
server's `quote`, its `free_tier` offer and a `hint` that starts with `paiement_requis` (`isError` is false).

Errors the package returns itself (a closed list, in `structuredContent.resultat.error`, `isError` true):
`plafond_depasse`, `paiement_refuse`, `reglement_incertain` (the connection broke after a signed payment was sent:
nothing is replayed, check your balance), `cle_invalide`, `compte_inactif`, `trop_de_requetes`,
`service_injoignable`. Errors of the Sirenic server itself (`amont_indisponible`, `compte_requis`,
`credits_insuffisants`...) reach your client unchanged.

## Tools

<!-- tools:start (generated by npm run tableau, do not edit) -->

112 tools (108 paid, 4 free) covering France and 19 other European countries, read from the Sirenic server 1.2.0 on 2026-10-08. Prices are in USD per call (per entity for batch tools), the same by API key and by x402.

| Tool | What it does | Price |
|---|---|---|
| `check_french_regulator_alerts` | French regulator alerts (AMF) | $0.01 |
| `compare_french_companies` | Compare French companies | $0.12 per entity |
| `create_surveillance_watch` | Create a company watch | from $0.05 (30 days) up to $0.50 (365 days) per entity |
| `detect_company_identifiers` | Detect company identifiers in text (free) | free |
| `download_french_company_document` | Download French company document | $0.10 |
| `find_expiring_french_public_contracts` | Expiring French public contracts | $0.05 |
| `get_belgian_company_filing` | Belgian annual accounts (NBB) | $0.15 |
| `get_belgian_insider_transactions` | Belgian insider transactions | $0.02 |
| `get_company_licences` | French regulatory authorisations | $0.02 |
| `get_company_procurement_competitors` | French procurement competitors | $0.02 |
| `get_croatian_company_accounts` | Croatian company annual-accounts filings | $0.01 |
| `get_croatian_company_events` | Croatian company court-register entries | $0.02 |
| `get_croatian_company_insolvency` | Croatian company insolvency (Sudski registar) | $0.02 |
| `get_cypriot_company_officers` | Cypriot company officers (DRCOR) | $0.01 |
| `get_czech_company_insolvency` | Czech company insolvency (ISIR) | $0.02 |
| `get_danish_company_filing` | Danish annual accounts | $0.05 |
| `get_danish_company_officers` | Danish company officers (CVR) | $0.01 |
| `get_estonian_company_accounts` | Estonian annual accounts | $0.02 |
| `get_estonian_company_officers` | Estonian company officers and governance | $0.01 |
| `get_estonian_company_registry_rulings` | Estonian registry rulings | $0.02 |
| `get_estonian_company_shareholders` | Estonian company members and shareholders | $0.02 |
| `get_eu_procurement_awards` | EU procurement awards (TED) | $0.02 |
| `get_european_company_eu_procurement` | European company EU procurement awards (TED) | $0.02 |
| `get_european_company_profile` | European company profile | $0.01 |
| `get_finnish_company_events` | Finnish trade-register notices (PRH) | $0.02 |
| `get_finnish_company_filing` | Finnish annual accounts (PRH) | $0.15 |
| `get_french_association_notices` | French association JOAFE notices | $0.01 |
| `get_french_association_profile` | French association profile (RNA) | $0.005 |
| `get_french_company_capital` | French company share capital | $0.35 |
| `get_french_company_changes` | French company changes (BODACC) | $0.01 |
| `get_french_company_collective_agreements` | French company collective agreements | $0.02 |
| `get_french_company_court_decisions` | French company court decisions | $0.01 |
| `get_french_company_default_risk` | French company default risk score | $0.10 |
| `get_french_company_default_risk_batch` | French default risk score, batch (2 to 100) | $0.07 per entity |
| `get_french_company_eu_funding` | EU research funding received (CORDIS) | $0.02 |
| `get_french_company_file` | French company file (choose blocks) | from $0.005 up to $0.35 (blocks chosen per call) |
| `get_french_company_financials` | French company financials | $0.01 |
| `get_french_company_health_summary` | French company health summary | $0.15 |
| `get_french_company_hiring_signals` | French hiring signals | $0.02 |
| `get_french_company_identity_batch` | French identity batch: SIREN, SIRET, VAT | $0.003 per entity |
| `get_french_company_industrial_risk` | French industrial risk (ICPE) | $0.01 |
| `get_french_company_intellectual_property` | French company IP portfolio | $0.03 |
| `get_french_company_intelligence` | French company intelligence report | $1.00 |
| `get_french_company_kyb_batch` | French KYB batch (2 to 100) | $0.105 per entity |
| `get_french_company_kyb_file` | French company KYB file | $0.15 |
| `get_french_company_legal_alerts` | French company legal alerts | $0.01 |
| `get_french_company_lobbying` | French lobbying register (HATVP) | $0.01 |
| `get_french_company_pdf_report` | French company PDF report | $0.50 |
| `get_french_company_profile` | French company profile (SIREN) | $0.005 |
| `get_french_company_public_procurement` | French public contracts won | $0.01 |
| `get_french_company_updates_since` | French company: everything new since a date | $0.05 |
| `get_french_public_buyer_profile` | French public buyer profile | $0.02 |
| `get_french_sector_benchmarks` | French sector benchmarks (NAF) | $0.05 |
| `get_german_insider_transactions` | German insider transactions | $0.02 |
| `get_irish_company_insolvency` | Irish company insolvency status (CRO) | $0.01 |
| `get_latvian_company_accounts` | Latvian annual accounts | $0.03 |
| `get_latvian_company_events` | Latvian company legal events | $0.02 |
| `get_latvian_company_insolvency` | Latvian company insolvency | $0.02 |
| `get_latvian_company_officers` | Latvian company officers | $0.01 |
| `get_latvian_company_public_procurement` | Latvian company public procurement (IUB) | $0.02 |
| `get_latvian_company_shareholders` | Latvian company members and shareholders | $0.02 |
| `get_lithuanian_company_accounts` | Lithuanian annual accounts | $0.02 |
| `get_lithuanian_company_insolvency` | Lithuanian company insolvency (JAR and AVNT) | $0.02 |
| `get_norwegian_company_accounts` | Norwegian annual accounts | $0.02 |
| `get_norwegian_company_legal_events` | Norwegian legal events | $0.02 |
| `get_norwegian_company_local_units` | Norwegian company local units (establishments) | $0.01 |
| `get_norwegian_company_officers` | Norwegian company officers and board | $0.01 |
| `get_polish_company_public_procurement` | Polish company public procurement (BZP) | $0.02 |
| `get_polish_company_registry_events` | Polish registry events (KRS) | $0.02 |
| `get_portuguese_company_public_procurement` | Portuguese company public procurement (Portal BASE) | $0.02 |
| `get_romanian_company_accounts` | Romanian annual accounts (Ministry of Finance) | $0.02 |
| `get_romanian_company_insolvency` | Romanian company insolvency (ONRC register) | $0.02 |
| `get_romanian_company_officers` | Romanian company legal representatives (ONRC) | $0.01 |
| `get_slovak_company_filing` | Slovak annual accounts (RUZ) | $0.03 |
| `get_spanish_company_acts` | Spanish company acts (BORME) | $0.02 |
| `get_spanish_company_public_procurement` | Spanish company public procurement (PLACSP) | $0.02 |
| `get_surveillance_watch` | Company watch status | free |
| `get_swedish_company_accounts` | Swedish annual accounts | $0.03 |
| `get_swedish_company_registry_events` | Swedish registry events | $0.02 |
| `get_swiss_company_events` | Swiss commercial-register publications (SOGC) | $0.02 |
| `get_swiss_company_insolvency` | Swiss company bankruptcy publications (SOGC) | $0.02 |
| `get_uk_beneficial_owners` | UK persons with significant control (PSC, legal entities) | $0.02 |
| `get_uk_company_accounts` | UK annual accounts (iXBRL) | $0.05 |
| `get_uk_company_gazette_notices` | UK insolvency notices (The Gazette) | $0.02 |
| `get_uk_company_insolvency` | UK company insolvency | $0.02 |
| `get_uk_company_officers` | UK company officers | $0.01 |
| `get_uk_company_public_procurement` | UK company public procurement (FTS, Contracts Finder) | $0.02 |
| `list_belgian_company_filings` | Belgian filings list (NBB) | $0.01 |
| `list_danish_company_filings` | Danish filings list (CVR) | $0.01 |
| `list_finnish_company_filings` | Finnish filings list (PRH) | $0.01 |
| `list_french_company_documents` | List French company documents (INPI) | $0.02 |
| `list_french_company_establishments` | French company establishments (SIRET) | $0.003 |
| `list_slovak_company_filings` | Slovak filings list (RUZ) | $0.01 |
| `list_uk_company_accounts` | UK accounts list (Companies House) | $0.01 |
| `prepare_european_invoice_file` | Prepare Belgian or Polish invoice file | $0.03 |
| `prepare_french_einvoicing_recipient` | Prepare French e-invoicing recipient | $0.02 |
| `prepare_french_invoice_file` | Prepare French invoice file | $0.03 |
| `prospect_french_companies` | Prospect French companies | $0.02 |
| `query_french_companies` | Query French companies by combined criteria | $0.002 to $0.02 |
| `renew_surveillance_watch` | Renew a company watch | from $0.05 (30 days) up to $0.50 (365 days) per entity |
| `screen_sanctions_lists` | Sanctions screening (AML) | $0.02 |
| `search_bodacc_announcements` | Search BODACC announcements | $0.03 |
| `search_eu_financial_authorisations` | Search EU financial authorisations (ESMA, ECB, EIOPA) | $0.01 |
| `search_european_companies` | Search European companies by name | $0.003 |
| `search_french_associations` | Search French associations by name | $0.002 |
| `search_french_companies` | Search French companies by name | $0.002 |
| `search_french_company_directors` | Search French company directors | $0.02 |
| `stop_surveillance_watch` | Stop a company watch | free |
| `suggest_company_names` | Suggest French company names (free) | free |
| `validate_eu_vat_number` | Validate EU VAT number (VIES) | $0.003 |
| `verify_french_invoice` | Verify a French invoice | $0.02 |
| `verify_iban_bank` | Verify IBAN and bank (SEPA) | $0.005 |

<!-- tools:end -->

## Recipes

Ready-made code for the REST API, x402 and n8n lives in
[sirenic-examples](https://github.com/sirenic-eu/sirenic-examples), the cookbook of this server.

## Limits

- Data comes from official registers and open data, served as is: a register that is late is late here too. Every
  paid response says its sources, their dates and what could not be checked (`provenance`).
- Natural persons are left out where a register mixes them with companies; a doubtful case is omitted, not served.
- The x402 rail pays in USDC on Base only. A payment cannot be refunded by this package.
- The snapshot only serves the tool list: no call works without the Sirenic server.
- No local HTTP listener in this version: use the hosted endpoint for HTTP clients.

## Star

If this server saved you a lookup, a star helps other developers find it.

[![Star History Chart](https://api.star-history.com/svg?repos=sirenic-eu/sirenic-mcp&type=Date)](https://star-history.com/#sirenic-eu/sirenic-mcp&Date)

## Contributing

Issues and pull requests are welcome: see [CONTRIBUTING.md](CONTRIBUTING.md). Tests run without network.

A `Dockerfile` is provided for MCP catalogues that build servers from source (Glama). It is built only by the CI of
this repository (job `docker`, which also starts the image) and by the catalogue itself: the maintainers do not build
it on their own machines.

## License

MIT, see [LICENSE](LICENSE). Data licences are those of each register, cited in every response.

Keywords: mcp, mcp-server, x402, company-data, kyb, europe, ai-agents.

TDQS

A3.6/5.0

Scored across 119 tools

Disambiguation2/5

Several clusters overlap heavily: six or more French 'whole dossier' tools (get_french_company_intelligence, get_french_company_kyb_file/batch, get_french_company_file, get_french_company_briefing, get_french_company_pdf_report, get_french_company_health_summary) return largely the same registers at different prices, and legal-events tools (legal_alerts, changes, updates_since, court_decisions, search_bodacc_announcements) are hard to separate at a glance. The invoice/payment cluster (prepare_french_invoice_file, prepare_french_einvoicing_recipient, verify_french_invoice, verify_iban_bank, prepare_european_invoice_file, validate_eu_vat_number) is also crowded. Descriptions do try hard to route the agent ('if you only need one part, call the dedicated tool'), which prevents a 1, but the sheer number of near-duplicate entry points makes misselection likely.

Naming Consistency3/5

Names are uniformly snake_case with a leading verb, which is good, but the verb vocabulary is loose: get_, list_, search_, query_, find_, prospect_, suggest_, detect_, compare_, check_, screen_ are all used for what is often the same 'look up companies by name' action (search_french_companies vs query_french_companies vs prospect_french_companies vs find_french_lookalike_companies vs suggest_company_names). Country prefixing is inconsistent: most tools carry a country token (get_french_company_*, get_latvian_company_*), but get_company_licences, get_company_procurement_competitors and find_expiring_french_public_contracts do not. The list_/get_ pairs per country (list_x_company_filings / get_x_company_filing) are a nice consistent sub-pattern.

Tool Count2/5

The scope is genuinely enormous (10+ national registers x ~15 data domains), so a large surface is defensible in principle, but 119 tools is far past what an agent can select from reliably and pushes well beyond the 25+ 'too many' threshold. Redundancy compounds the size: the aggregate French dossier tools and the per-country filing pairs repeat coverage that narrower tools already provide. No grouping, namespacing or progressive-disclosure mechanism is evident from the names alone.

Completeness4/5

For company due-diligence data the surface is remarkably complete: name-to-ID resolution, profiles, accounts, officers, shareholders, insolvency, procurement, IP, sanctions, VAT and a full watchlist lifecycle (create/get/renew/stop), plus free helper tools to turn text into identifiers. Gaps exist unevenly by country (e.g. Sweden has no officers, Germany only insider transactions, several countries lack shareholder or officer tools), but the descriptions state those absences as measured facts, so an agent can work around them.

Maintenance

ActivitySlowing
ResponsivenessNo recent community issues