Sirenic

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 carriessourceanddisclaimerfields.

Quickstart 0 — name → SIREN, for free (no wallet, no account, no key)

Every other call takes a SIREN. Getting one from a name costs nothing:

curl -s "https://api.sirenic.eu/v1/suggestions?q=carrefour"

Up to 5 matches, each withsiren,denomination,code_postal,commune,code_nafandactif. Source: the official INSEE Sirene register (open data). Drop it straight into a form's autocomplete, or let your agent resolve the name before it decides what to buy. Quota: 2,000 calls per day per IP.

It matches thestartof the registered name, then whole words (agricolefinds CRÉDIT AGRICOLE) — no typo tolerance and no match-confidence score. For those,GET /v1/recherchecosts $0.002. Then pick your paid call below.

Quickstart 1 — "Can you safely invoice or pay this company?"

One call, three answers: is the supplier still active, is its VAT number validtoday, and is that IBAN a real account at an identified bank. Start with the quote — free, no wallet, no account:

curl -i "https://api.sirenic.eu/v1/facturation/dossier?siren=552032534&iban=FR1420041010050500013M02606"

Then pay the $0.03 and get the file, with a deterministic verdict:

const res = await payingFetch( "https://api.sirenic.eu/v1/facturation/dossier?siren=552032534&iban=FR1420041010050500013M02606", ); const dossier = await res.json(); dossier.verdict.pret_a_facturer; // true | false dossier.verdict.raisons; // closed list: entreprise_cessee, tva_invalide_vies, iban_invalide…

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

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

You getHTTP 402with the x402 payment requirements in thePAYMENT-REQUIREDheader and a JSON body. Each quote carriestwo payment options at the same numeric amount— USDC (first, the default for existing clients) or EURC — with the official Circle contracts, receiving address and network.

Quickstart 3 — 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_KEYis the private key ofyour client test wallet(the payer). The server never holds any key. Theexactscheme uses signed authorizations, so the client pays no gas.

Quickstart 4 — plug into Claude / Cursor (MCP)

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

Cursor / any MCP client (mcpServersconfig):

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

import { sirenicTools } from "sirenic-agents"; // LangChain.js const tools = sirenicTools({ walletKey, maxPriceUsd: 0.25 });

from sirenic_agents import SirenicClient, build_crewai_tools # CrewAI / LangChain tools = build_crewai_tools(SirenicClient(wallet_key=key, max_price_usd=0.25))