fuentio-mcp

# Fuentio: France & Spain company data from official registries

**Official company checks for France and Spain, for AI agents.**

Fuentio is a remote MCP server (and REST API) that looks up, searches and verifies companies in
France and Spain from official registries: INSEE Sirene and the national company register for
France, BORME (Registro Mercantil acts since 2009) for Spain, and GLEIF for LEIs and company
group links. Every answer cites its source and check date. No setup, free tier.

```
https://api.fuentio.com/mcp
```

Ask your agent "Is this supplier still active?", "Which company is behind this SIREN?" or
"¿Sigue activa esta sociedad según el BORME?" and get an answer you can trust and prove.

## What you get

- Company lookup and search for France (SIREN, SIRET, name) and Spain (company name, BORME acts
  since January 2009).
- One record per real company, matched across registers and GLEIF, with the reason for every
  match and every non-match.
- Company group links (parent and subsidiary companies reported to GLEIF).
- Company history: what changed and when.
- A `verify_company` check for onboarding (KYB): status, address, identifiers and evidence in
  one call.
- Insolvency notices (BODACC for France, BORME for Spain).
- Sanctions list screening with clear coverage notes.
<!-- [if live] keep the next line only if watch_company passed its launch-day checks -->
- Change alerts with `watch_company`.

## Why agents pick it

- Official sources only, never scraped guesses.
- Every answer includes the source, a link, the check date, an uncertainty label and a receipt
  id.
- When sources disagree, you see both values, never a silent pick.
- Short answers by default, errors that say exactly what to retry.

## Install

**Claude Code**

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

**Claude Desktop / claude.ai:** Settings → Connectors → Add custom connector → paste
`https://api.fuentio.com/mcp`.

**Cursor / VS Code / any client (JSON),** as in this repository's [`mcp.json`](mcp.json):

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

VS Code's own `.vscode/mcp.json` format:

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

**Gemini CLI:** `gemini extensions install <this repository's URL>` (it reads
[`gemini-extension.json`](gemini-extension.json)).

**Cline:** ask Cline to install this server; it follows [`llms-install.md`](llms-install.md).

**ChatGPT (developer mode):** create a connector with the URL above, no authentication.

**With a key** (paid plans, or a free key for the tools marked "key" below):

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

A free key (100 units a month, one per person) takes under a minute:
`curl -X POST https://api.fuentio.com/v1/keys -H "Content-Type: application/json" -d '{"email":"you@example.com"}'`. The key arrives by email.

## Tools

| Tool | What it does | Cost |
|---|---|---|
| `list_coverage` | Countries, ID formats and official sources covered | free |
| `lookup_company` | A company by official ID: France SIREN (9 digits), SIRET (14), VAT; Spain Registro Mercantil sheet (e.g. `VI-23266`) | 1 unit |
| `search_companies` | Find a company by name, 10 per page | 2 units |
| `get_company_history` | What changed at a company, and when, each change with its source | 1 unit |
| `verify_company` | Onboarding (KYB) check: outcome with reasons, warning signals, receipt | 5 units |
| `resolve_company` | Is this the same company? Candidates with evidence, from an ID or a name and town | 2 units |
| `explain_match` | Why two records are, or are not, the same company | 1 unit |
| `get_evidence` | Every value behind a company's facts, each with its source and date | 1 unit |
| `what_changed` | What changed at a company since a date, across all its records | 1 unit |
| `get_graph` | A company's group: GLEIF parents and subsidiaries, every link with its source (key) | 2 units |
| `check_insolvency` | Insolvency notices: BODACC (France), BORME insolvency acts (Spain) | 1 unit |
| `screen_company` | The company's own names against the EU, UK, OFAC and French sanctions lists (key) | 2 units |
| `check_address` | A French company's registered address against the Base Adresse Nationale | 1 unit |
| `check_vat` | A French company's EU VAT number, with a link to check it on VIES | 1 unit |
| `review_report` | One review-ready report: identity, facts with sources, changes, every check (key) | 8 units |
| `watch_company` | Signed webhooks when a company's official records change (key) | 1 unit |
| `report_issue` | Report an answer you believe is wrong, so it is checked against the source (key) | free |

Prompt: `check_a_company(country, name_or_id)` finds and verifies a company, then answers in one
paragraph with the outcome, source, check date and receipt.

## Sources

- **France:** INSEE Sirene and the Registre national des entreprises, through the Annuaire des
  Entreprises; BODACC; Base Adresse Nationale. Licence Ouverte / Etalab 2.0.
- **Spain:** BORME, the Registro Mercantil gazette published by the Agencia Estatal Boletín
  Oficial del Estado (https://www.boe.es).
- **Both:** GLEIF (LEIs and parent links, CC0); the EU, UK, OFAC and French sanctions lists.

## Limits

- Keyless trial: 20 units a day. Free key: 100 units a month. Paid plans:
  https://fuentio.com/pricing/
- France and Spain only.
- Spain covers companies with an act published in BORME since 2 January 2009, not every Spanish
  company. No Spanish NIF/CIF lookup: search by name instead.
- No full financial statements, no beneficial owners, no credit scores, no data about people.
- Fuentio does not check VAT registration: `check_vat` gives the number and links VIES.

## Licence

The documentation and install snippets in this repository are MIT-licensed. The Fuentio service
and its data are governed by the terms at https://fuentio.com and the sources' licences above.

Contact: hello@fuentio.com