search_french_companies

Search French companies by name or SIREN (official INSEE Sirene / INPI RNE data). Returns the top 10 matches. Paid via x402 ($0.001 in USDC).

Parameters2

q	string	required	Company name or 9-digit SIREN
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Company name or 9-digit SIREN"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_french_company_profile

Full official profile of a French company by SIREN: legal name, legal form, head office, NAF code, workforce, officers, collective agreements, VAT number. Paid via x402 ($0.005 in USDC).

Parameters2

siren	string	required	9-digit SIREN
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "siren": {
      "type": "string",
      "pattern": "^\\d{9}$",
      "description": "9-digit SIREN"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "siren"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_french_company_establishments

List all establishments (SIRET) of a French company with addresses and status. Paid via x402 ($0.003 in USDC).

Parameters2

siren	string	required	9-digit SIREN
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "siren": {
      "type": "string",
      "pattern": "^\\d{9}$",
      "description": "9-digit SIREN"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "siren"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_french_company_default_risk

Default-risk score (0-100) for a French company at ~12 months: a transparent, documented scorecard from filed financial ratios (structure, profitability, liquidity, debt service, trend) + company age + a hard BODACC override (active insolvency / liquidation). Returns score, qualitative band, every component with its threshold, and a confidence level. Decision-support only — NOT a solvency opinion or credit rating. Paid via x402 ($0.10 in USDC).

Parameters2

siren	string	required	9-digit SIREN
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "siren": {
      "type": "string",
      "pattern": "^\\d{9}$",
      "description": "9-digit SIREN"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "siren"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_french_sector_benchmarks

Sector benchmarks for a French NAF activity code (any level: 68, 68.2, 68.20, 68.20B): number of active companies, median company age (+quartiles), workforce-bracket distribution, and — when at least 5 companies file public accounts — median revenue, EBITDA margin, pre-tax result and debt ratio. Place a company against its peers. Aggregates only, no personal data. Paid via x402 ($0.05 in USDC).

Parameters2

code_naf	string	required	NAF activity code, any level
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "code_naf": {
      "type": "string",
      "pattern": "^\\d{2}(\\.\\d{0,2}[A-Z]?)?$",
      "description": "NAF activity code, any level"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "code_naf"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_french_company_intellectual_property

Industrial-property portfolio of a French company from INPI open data: trademarks, patents and designs filed (counts + recent items with number, title, status, date, classification). An R&D/brand-value signal. Patent inventor names (natural persons) are never returned. Paid via x402 ($0.03 in USDC).

Parameters2

siren	string	required	9-digit SIREN
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "siren": {
      "type": "string",
      "pattern": "^\\d{9}$",
      "description": "9-digit SIREN"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "siren"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_french_company_changes

New official BODACC gazette announcements for a French company SINCE a given date (poll-mode surveillance for a portfolio): insolvency, deregistration, sales, filings, changes — reverse-chronological. Detects new BODACC publications, not field-level edits of the profile. A company with no new announcement returns an empty list. Paid via x402 ($0.01 in USDC).

Parameters3

siren	string	required	9-digit SIREN
depuis	string	required	List announcements since this date (YYYY-MM-DD)
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "siren": {
      "type": "string",
      "pattern": "^\\d{9}$",
      "description": "9-digit SIREN"
    },
    "depuis": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "List announcements since this date (YYYY-MM-DD)"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "siren",
    "depuis"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_french_company_directors

Reverse director search: list the French companies where a person of a given surname holds (or held) an office, with the company SIREN, name and the person's role — for due diligence and network mapping. Person data limited to surname, first names, role and birth year. Homonyms are not disambiguated; common names are capped. Paid via x402 ($0.02 in USDC).

Parameters2

nom	string	required	Director surname to search
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "nom": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Director surname to search"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "nom"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_french_company_legal_alerts

Legal alerts for a French company from the official BODACC gazette: insolvency proceedings, deregistrations, business sales. Paid via x402 ($0.01 in USDC).

Parameters2

siren	string	required	9-digit SIREN
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "siren": {
      "type": "string",
      "pattern": "^\\d{9}$",
      "description": "9-digit SIREN"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "siren"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_french_company_financials

Annual financial data of a French company from filed accounts (revenue, EBITDA, net income, ratios — INPI/Banque de France), plus the full structured tax-form line items (liasse fiscale) from the INPI registry for the latest 3 public fiscal years. Paid via x402 ($0.01 in USDC).

Parameters2

siren	string	required	9-digit SIREN
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "siren": {
      "type": "string",
      "pattern": "^\\d{9}$",
      "description": "9-digit SIREN"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "siren"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_french_company_public_procurement

Public procurement contracts won by a French company (official DECP data): buyers, amounts, dates. Paid via x402 ($0.01 in USDC).

Parameters2

siren	string	required	9-digit SIREN
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "siren": {
      "type": "string",
      "pattern": "^\\d{9}$",
      "description": "9-digit SIREN"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "siren"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_european_companies

Search European companies by name across official registers in one unified schema (Norway, Estonia, Latvia local bases; Denmark/UK when enabled; worldwide GLEIF/LEI coverage). Paid via x402 ($0.003 in USDC).

Parameters3

q	string	required	Company name
pays	string	optional	Optional ISO-3166 alpha-2 country filter, e.g. NO, EE, LV
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Company name"
    },
    "pays": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Optional ISO-3166 alpha-2 country filter, e.g. NO, EE, LV"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_european_company_profile

Unified European company profile by country and national register ID — same JSON schema for every country (identity, legal form, normalized status, head office, VAT, LEI, official register link). Paid via x402 ($0.01 in USDC).

Parameters3

pays	string	required	ISO-3166 alpha-2 country code, e.g. NO
id	string	required	National register identifier, e.g. 923609016
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "pays": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "ISO-3166 alpha-2 country code, e.g. NO"
    },
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9.-]{1,20}$",
      "description": "National register identifier, e.g. 923609016"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "pays",
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_french_company_pdf_report

On-demand PDF report of a French company (formatted KYB file: identity, officers, legal alerts, financials, sanctions screening; includes the AI health summary when cached). Returns the PDF as base64. Paid via x402 ($0.50 in USDC).

Parameters2

siren	string	required	9-digit SIREN
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "siren": {
      "type": "string",
      "pattern": "^\\d{9}$",
      "description": "9-digit SIREN"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "siren"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_french_company_documents

List official documents filed by a French company at the INPI RNE registry: legal deeds (statutes, general-meeting minutes, mergers...) and filed annual accounts, with document IDs to download the PDFs. Paid via x402 ($0.02 in USDC).

Parameters2

siren	string	required	9-digit SIREN
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "siren": {
      "type": "string",
      "pattern": "^\\d{9}$",
      "description": "9-digit SIREN"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "siren"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

download_french_company_document

Download an official company document (PDF) from the INPI RNE registry: statutes, general-meeting minutes, filed annual accounts... Use IDs from list_french_company_documents. Returns the PDF as base64 — documents typically weigh 1-10 MB. Paid via x402 ($0.10 in USDC).

Parameters3

type	string	required	Document family from the list tool
document_id	string	required	Document `id` from list_french_company_documents
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "actes",
        "bilans"
      ],
      "description": "Document family from the list tool"
    },
    "document_id": {
      "type": "string",
      "pattern": "^[a-f0-9]{24}$",
      "description": "Document `id` from list_french_company_documents"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "type",
    "document_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

prospect_french_companies

Multi-criteria prospecting over the full French registry (29.8M companies): filter by NAF activity code, departement/postal code, legal form, workforce, age, RGE certification, gender-equality index. Returns up to 100 active companies per page; each page is one x402 payment ($0.02 in USDC).

Parameters12

naf	string	optional	NAF/APE code or prefix, e.g. 62 or 62.01Z
departement	string	optional	French departement: 75, 2A, 971…
code_postal	string	optional	Postal-code prefix (2-5 digits), exclusive with departement
forme_juridique	string	optional	INSEE legal-category prefix, e.g. 54
effectif_min	integer	optional
effectif_max	integer	optional
age_min	integer	optional	Minimum company age in years
age_max	integer	optional
rge	boolean	optional	true = active RGE environmental certification
egapro_min	integer	optional	Minimum gender-equality index (0-100)
page	integer	optional	Page number (one payment per page)
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "naf": {
      "type": "string",
      "description": "NAF/APE code or prefix, e.g. 62 or 62.01Z"
    },
    "departement": {
      "type": "string",
      "description": "French departement: 75, 2A, 971…"
    },
    "code_postal": {
      "type": "string",
      "description": "Postal-code prefix (2-5 digits), exclusive with departement"
    },
    "forme_juridique": {
      "type": "string",
      "description": "INSEE legal-category prefix, e.g. 54"
    },
    "effectif_min": {
      "type": "integer"
    },
    "effectif_max": {
      "type": "integer"
    },
    "age_min": {
      "type": "integer",
      "description": "Minimum company age in years"
    },
    "age_max": {
      "type": "integer"
    },
    "rge": {
      "type": "boolean",
      "description": "true = active RGE environmental certification"
    },
    "egapro_min": {
      "type": "integer",
      "description": "Minimum gender-equality index (0-100)"
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Page number (one payment per page)"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_french_company_health_summary

AI-generated business-health summary of a French company (in French), produced from official data only: strengths, warning signs, activity trend, confidence level. Cached 7 days. Paid via x402 ($0.15 in USDC).

Parameters2

siren	string	required	9-digit SIREN
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "siren": {
      "type": "string",
      "pattern": "^\\d{9}$",
      "description": "9-digit SIREN"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "siren"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_french_company_kyb_file

Complete KYB (Know Your Business) file for a French company in one call: identity, officers, BODACC legal alerts, filed financials, sanctions screening of the company and each officer (5 official lists), VAT number, completeness score. Paid via x402 ($0.15 in USDC).

Parameters2

siren	string	required	9-digit SIREN
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "siren": {
      "type": "string",
      "pattern": "^\\d{9}$",
      "description": "9-digit SIREN"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "siren"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_french_company_kyb_batch

Batch KYB: full KYB files for 2 to 100 French companies in one call. Billed per company at $0.105 (30% off the $0.15 unit price) via x402 — the amount is the unit price times the number of SIREN. A SIREN with no diffusible company is returned with trouve=false and billed as one lookup. Ideal for prospecting and compliance agents processing lists.

Parameters2

sirens	array	required	List of 2 to 100 nine-digit SIRENs
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "sirens": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\d{9}$"
      },
      "minItems": 2,
      "maxItems": 100,
      "description": "List of 2 to 100 nine-digit SIRENs"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "sirens"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

screen_sanctions_lists

Screen a person or company name against the 5 official sanctions lists (UN consolidated, EU FSF, US OFAC SDN, UK Sanctions List, French asset-freeze register). Returns fuzzy matches with a 0-100 confidence score — never a bare yes/no. Paid via x402 ($0.02 in USDC).

Parameters3

name	string	required	Person or company name to screen
birth_year	string	optional	Optional birth year (YYYY) to refine person matches
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 100,
      "description": "Person or company name to screen"
    },
    "birth_year": {
      "type": "string",
      "pattern": "^\\d{4}$",
      "description": "Optional birth year (YYYY) to refine person matches"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

validate_eu_vat_number

Validate any EU intra-community VAT number against the official VIES service (all member states). Paid via x402 ($0.003 in USDC).

Parameters2

vat_number	string	required	Full VAT number with country prefix, e.g. FR27552032534
x_payment	string	optional	Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote.

Raw schema

{
  "type": "object",
  "properties": {
    "vat_number": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}[A-Za-z0-9+*]{2,12}$",
      "description": "Full VAT number with country prefix, e.g. FR27552032534"
    },
    "x_payment": {
      "type": "string",
      "description": "Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote."
    }
  },
  "required": [
    "vat_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Sirenic

MCP Server: eu.sirenic/sirenic

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

search_french_companies

get_french_company_profile

list_french_company_establishments

get_french_company_default_risk

get_french_sector_benchmarks

get_french_company_intellectual_property

get_french_company_changes

search_french_company_directors

get_french_company_legal_alerts

get_french_company_financials

get_french_company_public_procurement

search_european_companies

get_european_company_profile

get_french_company_pdf_report

list_french_company_documents

download_french_company_document

prospect_french_companies

get_french_company_health_summary

get_french_company_kyb_file

get_french_company_kyb_batch

screen_sanctions_lists

validate_eu_vat_number

Install

Remote endpoint