Fuentio: France & Spain company data

npx add-mcp 'https://api.fuentio.com/mcp'

Official company records your agent can use, and cite.

Fuentio runs an MCP server, so Claude, Cursor and any MCP client can verify a French or Spanish company in the middle of a task. Every answer starts with one plain sentence and ends with its source.

Built for AI agents: one MCP server and one REST API, with honest gaps: what isn't covered is said, never guessed.

Every country, covered or not →

Connect it to your agent

1. Claude Code One command, no key needed to start.

   claude mcp add --transport http fuentio https://api.fuentio.com/mcp
   

   With a key

   claude mcp add --transport http fuentio https://api.fuentio.com/mcp \
     --header "Authorization: Bearer YOUR_API_KEY"
   

2. Claude Desktop and claude.ai
   1. Settings → Connectors → Add custom connector. 2. Name: Fuentio. URL: the address below. Then Add. 3. In a chat, turn on Fuentio from the tools menu and ask, for example, “Is SIREN 441639465 still active?” Custom connectors can't send a key, so they use the keyless trial.

   https://api.fuentio.com/mcp
   

3. Cursor In ~/.cursor/mcp.json, or.cursor/mcp.json in a project.

   {
     "mcpServers": {
       "fuentio": {
         "url": "https://api.fuentio.com/mcp"
       }
     }
   }
   

   With a key

   {
     "mcpServers": {
       "fuentio": {
         "url": "https://api.fuentio.com/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_API_KEY"
         }
       }
     }
   }
   

4. VS Code (GitHub Copilot agent mode) In.vscode/mcp.json. With a key, VS Code asks for it once and stores it securely.

   {
     "servers": {
       "fuentio": {
         "type": "http",
         "url": "https://api.fuentio.com/mcp"
       }
     }
   }
   

   With a key

   {
     "inputs": [
       {
         "type": "promptString",
         "id": "fuentio-key",
         "description": "Fuentio API key",
         "password": true
       }
     ],
     "servers": {
       "fuentio": {
         "type": "http",
         "url": "https://api.fuentio.com/mcp",
         "headers": {
           "Authorization": "Bearer ${input:fuentio-key}"
         }
       }
     }
   }
   

5. ChatGPT (developer mode)
   1. Settings → Apps & Connectors → Advanced settings: turn on Developer mode. 2. Create a connector: name Fuentio, MCP server URL: the address below, authentication: No authentication. 3. In a chat, pick the connector from the tools menu and ask your question. Menu names change often; ChatGPT's help pages have the current path. ChatGPT connectors use the keyless trial.

   https://api.fuentio.com/mcp
   

6. Any streamable-HTTP client Stateless, JSON responses. No key needed to start.

   POST https://api.fuentio.com/mcp
   Accept: application/json, text/event-stream
   

   With a key

   POST https://api.fuentio.com/mcp
   Accept: application/json, text/event-stream
   Authorization: Bearer YOUR_API_KEY
   

The tools Live

• list_coverage () Free Which countries and identifier formats are covered, and how fresh the data is. Call it first when unsure.
• lookup_company (country, identifier, id_scheme?, format?) 1 unit Verify a company before onboarding, paying or contacting it. France: SIREN, SIRET or VAT number. Spain: Registro Mercantil sheet.
• search_companies (country, query, postal_code?, locality?, status?, page?, format?) 2 units Find a company by name when you don't know its number.
• get_company_history (country, identifier, page?) 1 unit See what changed at a company (status, address, name, legal form) and when, with the official source of each change. Spain also gets its BORME acts as dated events.
• verify_company (country, identifier, id_scheme?, reference?) 5 units A KYB check for onboarding, or before paying or signing: an outcome (verified, partial or unverified), the reasons and a proof code. Use lookup_company for a quick read, and search_companies first when you only have a name.
• resolve_company (country, name?, identifier?, postal_code?, locality?) 2 units Is this the same company? Match a supplier or customer record (an official ID, or a name with a postcode or town) to the official registers: candidates, each with a decision and the reasons. Only an official ID links; a name is never proof.
• explain_match (left, right) 1 unit Why two register records are, or are not, the same company: the decision, the reason codes and the evidence.
• watch_company (entity_id, callback_url) 1 unit Watch a company: when its official records change, Fuentio sends the changes, signed, to your https endpoint. Needs an API key.

Export formats

lookup_company and search_companies, and the REST lookup and search, take an optional format. Same units, except a search file with more than 25 rows: 2 units per started 25 rows.

• JSON
• CSV
• Excel
• Markdown
• HTML
• XML
• NDJSON
• Parquet
• TSV
• At most 100 rows per answer.
• Excel and Parquet come back as a download link that works for 24 hours.
• Every row keeps its source and check time.

A search as CSV

curl "https://api.fuentio.com/v1/companies/search?country=FR&q=renault&format=csv"

Which tool when

Your question	Tool
You only have a company's name.	search_companies
You have a SIREN, SIRET or VAT number, or a Spanish registry sheet.	lookup_company
You are onboarding a company and need a KYB check.	verify_company
You want to know what changed, and when.	get_company_history
You have a supplier or customer record and need to know which registered company it is.	resolve_company
You want to hear when a company changes.	watch_company
You are not sure what is covered.	list_coverage

What your agent sees

A real record from our snapshot, as the lookup tool returns it:

The tool call

lookup_company({"country": "FR", "identifier": "441639465"})

The first line your agent reads

RENAULT (FR, SIREN 441639465) is active as of 2025-12-06, source: Annuaire des Entreprises (API Recherche d'entreprises).

Then the full record as JSON, with its source, licence and check time.

Prefer plain REST?

The same data over HTTPS. Try it without a key, then create a free key in one call.

A free trial without a key (20 units a day), and free keys with 100 units a month.

Look up a company, no key needed

curl https://api.fuentio.com/v1/companies/FR/441639465

Create a free key

curl -X POST https://api.fuentio.com/v1/keys