sirenic

Connectors · MCP

Your assistant cites the register instead of guessing.

Our 109 tools covering French and European company data plug into an assistant by pasting a single URL. It then queries the official registers itself, without you leaving the conversation, and every response is sourced and signed.

The URL to paste, the same for every client

https://api.sirenic.eu/mcp/connecteur

Tools
109
Transport
Streamable HTTP
Authentication
OAuth or key

Installation

Pick your tool.

Claude (claude.ai, Claude Desktop)

  1. 01Settings, then Connectors, then “Add custom connector”.
  2. 02Paste the URL above.
  3. 03Claude discovers on its own that authentication is needed and opens our sign-in window: sign in, authorise.

Path checked on 31/08/2026.

Claude Code

  1. 01Add the server in one command, with your key as a header:
  2. 02Without a header, the OAuth flow opens in your browser.
claude mcp add --transport http sirenic \
  https://api.sirenic.eu/mcp/connecteur \
  --header "X-Api-Key: srn_live_…"

Path checked on 31/08/2026.

Claude Desktop, Cursor (local server)

  1. 01The open-source sirenic-mcp package serves the agents' catalogue (/mcp) locally (stdio): paste this block into the client's MCP configuration (claude_desktop_config.json, or ~/.cursor/mcp.json).
  2. 02Your key in SIRENIC_API_KEY; or, without an account, an x402 wallet in SIRENIC_WALLET_KEY, capped at $0.05 per call and $0.50 per session.
{
  "mcpServers": {
    "sirenic": {
      "command": "npx",
      "args": [
        "-y",
        "sirenic-mcp"
      ],
      "env": {
        "SIRENIC_API_KEY": "srn_live_..."
      }
    }
  }
}
The source code, and the list of tools with each one's price →

Path checked on 09/10/2026.

ChatGPT

  1. 01First enable developer mode: Settings, Apps, Advanced settings, “Developer mode”.
  2. 02Settings, Connectors, Create: name, description and the URL above.
  3. 03Choose OAuth authentication.

Path checked on 31/08/2026.

Le Chat (Mistral)

  1. 01Settings, Connectors, custom connector.
  2. 02“Streamable HTTP” transport, then the URL above.
  3. 03The OAuth authorisation opens at creation time.

Path checked on 31/08/2026.

Perplexity

  1. 01Settings, “+ Custom connector”, then “Remote”.
  2. 02Paste the URL above.
  3. 03Two choices work: OAuth (the endpoints are discovered automatically) or API key.

Path checked on 31/08/2026.

n8n

  1. 01“MCP Client” node, HTTP transport.
  2. 02The URL above, and the X-Api-Key header with your key.
  3. 03For workflows without an agent, the n8n-nodes-sirenic community node calls the same routes.
The 12 ready-to-import n8n workflows →

Path checked on 31/08/2026.

Make

  1. 01Download a ready-made scenario from the Workflows page (.make.json file).
  2. 02In Make: create a scenario, then “Import Blueprint”.
  3. 03In every HTTP module, under Credentials, a key of type API key: your srn_live_… key, placed in the X-Api-Key header. It is created once for all modules.
The 12 ready-to-import Make scenarios →

These scenarios only use Make's HTTP modules. The Sirenic app for Make is under review at Make.

Path checked on 24/09/2026.

Authentication

Two ways to authenticate.

1. OAuth

  • The client opens a Sirenic window: you sign in, you authorise, and that is it.
  • Nothing to type in: no client ID, no secret. Registration happens on its own.
  • The token issued expires after one hour and renews itself until you revoke it.

2. API key

  • For clients offering an API key instead of OAuth.
  • Your srn_live_… key goes in X-Api-Key or Authorization: Bearer.
  • Create the key in your account, and revoke it in the same place.
Create a key

Exposed tools

What your assistant can do.

Find

prospect_french_companies
search_french_companies
get_french_company_profile

Assess

get_french_company_financials
get_french_company_default_risk
get_french_sector_benchmarks

Check

screen_sanctions_lists
get_french_company_legal_alerts
get_french_company_kyb_file

Monitor

create_surveillance_watch
get_surveillance_watch
renew_surveillance_watch

Four families among the 109 tools. Each tool states its routes and their prices in the list the server serves (tools/list), and every route has its price on the pricing page. The full list of tools, with each one's price, is also in the local package repository.

Three prompts to get started

Once the connector is plugged in there is nothing to configure: ask the question, the assistant picks the tool.

Build a prospect list

“List active computer programming companies (NAF 62.01Z) in the Rhône department with 10 to 49 employees, then check the first one before we contact them.”

prospect_french_companies · get_french_company_profile

Judge a customer before granting credit

“Give me the default risk and the latest filed accounts for SIREN 552032534, and compare it with its sector average.”

get_french_company_default_risk · get_french_company_financials · get_french_sector_benchmarks

Screen a counterparty before signing

“Is this company under sanctions, and does it have any BODACC gazette announcements in the last six months?”

screen_sanctions_lists · get_french_company_legal_alerts

Troubleshooting

If the connector refuses a call.

Missing or refused key

The service answers invalid_token when the client sends no token, or a token that is unknown, revoked or expired. With OAuth, reconnect the connector from the client: it reopens the Sirenic window. With a key, create one in your account and paste it again in X-Api-Key. A suspended or closed account gets account_inactive.

Monthly quota used up

Every account has 150 free calls a month on the tools in the quota. Beyond that, a call is paid from the account credits; with no credits, the service answers credits_insuffisants, with the balance and the price, and nothing is billed. The quota starts again at the beginning of the next month (Paris time).

Credits

Prepaid credits: card top-up is not open yet. An account with no credits therefore serves the tools in the quota, up to 150 calls a month, and nothing beyond.

Tool outside the quota

The free quota leaves out 14 of the 109 tools: priced above $0.05, per-entity (except an identity batch of up to 50 lines, which is in it) or per-block amount, registry document, metered source. They are paid from credits from the first call. The credits_insuffisants refusal does not say whether the quota is used up or the tool is outside it: each tool's description ends with its billing, “in its free monthly quota” or “not in the free monthly quota”, with the reason.

Claude Code and the loopback address

Without a header, Claude Code opens the OAuth authorisation in your browser and comes back to an address on your computer (localhost or 127.0.0.1, on a port that changes every session). The authorisation screen shows that address and warns that any program on the computer can claim this name: authorise only if you have just started Claude Code. With the X-Api-Key header (command above), nothing opens.

A tool is missing

The PDF report, the Belgian filing and the INPI document are not on the connector: a file of several megabytes does not fit in a conversation. The REST API serves them, with the same key.

What it costs

Plugging in an assistant changes no price.

Open today: 150 free calls a month with an account, on 109 of 125 routes (the price list says which), and pay-per-call over x402 (USDC or EURC), with no account except registry filings. Prepaid credits: card top-up is not open yet.

See pricing

What the authorisation allows, and what it does not

  • It allows calling the data routes on your behalf, against your quota and then your balance.
  • It grants access to neither your email address nor your invoices, and allows neither topping up nor closing the account.
  • You cut access off whenever you want: the connector appears among your API keys, marked “Connector”, and is revoked in one click.

My keys and connectors

Badge

A badge for your README.

A project that reads company data through Sirenic can say so with an image, served by our servers, with no script and no cookie. Paste this snippet into its README:

company data | Sirenic

[![company data | Sirenic](https://api.sirenic.eu/badge/company-data.svg)](https://api.sirenic.eu/en?utm_source=badge&utm_campaign=developpeur)

A KYB file, a PDF report or a briefing carries a verification number (X-Sirenic-Verification-Id header). When its receipt names a legal entity, its badge states what was issued and the day of issue, and leads to the public receipt of the response; otherwise (a sole trader, for instance), the badge address answers 404. No SIREN and no name in the image. Replace {number} with that number:

[![Sirenic](https://api.sirenic.eu/badge/{number}.svg)](https://api.sirenic.eu/verifier/{number}?utm_source=badge)

Template reward

Publish a template, get 20 credits (EUR 20).

Have you published a template that calls api.sirenic.eu in the n8n or Make gallery? We give 20 credits (EUR 20) to its author's Sirenic account, once per template.

  1. The template is public in the n8n gallery (n8n.io/workflows) or the Make gallery (make.com/en/templates). One of its steps calls a route of api.sirenic.eu, with the API key passed through the tool's credentials: no key or secret is written in the template.
  2. One template per author and per use case: two templates that call the same main Sirenic route count as one. A template is never rewarded twice, whichever account presents it.
  3. The account that receives the credits is verified and active. To claim the reward, write to contact@sirenic.eu from that account's address, with the public address of the template.
  4. We check the template before crediting. We refuse a template that is private, removed or still in review, that does not call api.sirenic.eu, that contains a key or a secret, that copies an existing template (ours included), that promises what Sirenic does not serve (beneficial owners, for instance), or whose description or examples name a real person.
  5. The 20 credits are credited once, to the account's balance. They are spent on every route, like purchased credits. They are valid for 6 months from the credit. They cannot be bought, exchanged or refunded; they end with the account.
  6. If two accounts present the same template, the first claim we check gets it; an author who disagrees proves authorship by adding to the template description a word we provide.