Examples

See real answers

Eight questions an agent or a person asks, and what the live API answered on 12 October 2026. Nothing is mocked: each answer was recorded from the MCP server without a key.

  1. Asked

    “Is SIREN 552032534 still active? Give sources.”

    Tool lookup_company {"country": "FR", "identifier": "552032534"}

    Answer, as returned

    DANONE (FR, SIREN 552032534) is active as of 2026-09-10, source: Annuaire des Entreprises (API Recherche d'entreprises).

    Show the answer (JSON, trimmed)
    {
      "data": {
        "id": "FR-SIREN-552032534",
        "name": {
          "original": "DANONE",
          "latin": "DANONE",
          "script": "Latn",
          "language": "fr"
        },
        "status": {
          "value": "active",
          "original_label": "Active",
          "as_of": "2026-09-10"
        },
        "legal_form": {
          "original_code": "5599",
          "original_label": "SA à conseil d'administration (s.a.i.)",
          "elf_code": "K65D",
          "category": "public_limited_company"
        },
        "registered_address": {
          "original": "59-61 RUE LA FAYETTE 75009 PARIS",
          "street": "59 RUE LA FAYETTE",
          "postal_code": "75009",
          "locality": "PARIS",
          "region": null,
          "country": "FR"
        },
        "provenance": {
          "source": "fr_recherche_entreprises",
          "source_url": "https://recherche-entreprises.api.gouv.fr/search?q=552032534&per_page=1",
          "license": "Licence Ouverte / Etalab 2.0 (Annuaire des Entreprises, INSEE Sirene); officers: INPI RNE reuse licence",
          "last_verified_at": "2026-10-11T22:06:01.689264Z"
        }
      },
      "meta": {
        "last_verified_at": "2026-10-11T22:06:01.689264+00:00",
        "update_frequency": "daily (INSEE Sirene + INPI RNE)",
        "stale": false,
        "uncertainty": "The sources holding this entity agree on every field they share."
      }
    }

    Why this matters Status with its date, the official source, its licence and when it was checked: ready to quote in a file.

    Recorded on 12 October 2026 from https://api.fuentio.com/mcp.

  2. Asked

    “Verify this supplier for onboarding: SIREN 552100554.”

    Tool verify_company {"country": "FR", "identifier": "552100554"}

    Answer, as returned

    FR data: partial coverage (All French companies in the public Sirene directory, live from the official Annuaire des Entreprises API (refreshed after 7 days).). PEUGEOT SA (FR, SIREN 552100554): unverified, inactive per Annuaire des Entreprises (API Recherche d'entreprises), checked 2026-10-12. Proof FUE-FR-20261012-C8G7R6.

    Show the answer (JSON, trimmed)
    {
      "data": {
        "proof_code": "FUE-FR-20261012-C8G7R6",
        "checked_at": "2026-10-12T00:22:46.759202+00:00",
        "result": {
          "outcome": "unverified",
          "reasons": [
            "company_inactive"
          ],
          "summary": "FR data: partial coverage (All French companies in the public Sirene directory, live from the official Annuaire des Entreprises API (refreshed after 7 days).). PEUGEOT SA (FR, SIREN 552100554): unverified, inactive per Annuaire des Entreprises (API Recherche d'entreprises), checked 2026-10-12. Proof FUE-FR-20261012-C8G7R6."
        },
        "checks": [
          {
            "check": "identifier_valid",
            "result": "pass",
            "detail": "The ID has a valid format."
          },
          {
            "check": "record_found",
            "result": "pass",
            "detail": "Found in the official source."
          },
          {
            "check": "status_active",
            "result": "fail",
            "detail": "Register status: inactive."
          },
          {
            "check": "address_present",
            "result": "pass",
            "detail": "Registered address published."
          },
          {
            "check": "fresh",
            "result": "pass",
            "detail": "Checked against the source within its refresh window."
          }
        ],
        "signals": {
          "closure": {
            "value": "present",
            "evidence": [
              {
                "date": "2021-01-16",
                "source_url": "https://recherche-entreprises.api.gouv.fr/search?q=Peugeot+SA&page=1&per_page=10"
              }
            ]
          },
          "insolvency": {
            "value": "not_covered",
            "evidence": []
          }
        }
      }
    }

    Why this matters An honest “unverified”, with the reason and a proof code, instead of a green tick.

    Recorded on 12 October 2026 from https://api.fuentio.com/mcp.

  3. Asked

    “Any insolvency notices for Peugeot SA (552100554)?”

    Tool check_insolvency {"country": "FR", "identifier": "552100554"}

    Answer, as returned

    Insolvency: not_covered; 0 notice(s).

    Show the answer (JSON, trimmed)
    {
      "data": {
        "company": {
          "country": "FR",
          "id": "FR-SIREN-552100554",
          "name": "PEUGEOT SA"
        },
        "state": "not_covered",
        "procedure": null,
        "opened_on": null,
        "closed_on": null,
        "notices": [],
        "covered_since": "2008-02-13",
        "attribution": "Source: DILA, BODACC",
        "note": "From BODACC A insolvency notices (DILA), linked by SIREN. Notices about people and personal sanctions are left out. No notice outside the loaded years is not proof of no procedure."
      }
    }

    Why this matters It says what it could not cover. No notice is never presented as proof of no procedure.

    Recorded on 12 October 2026 from https://api.fuentio.com/mcp.

  4. Asked

    “What changed at Renault?”

    Tool get_company_history {"country": "FR", "identifier": "441639465"}

    Answer, as returned

    RENAULT (FR-SIREN-441639465): 4 stored version(s); latest change: nothing yet. History since 2026-10-05 (History starts the first time Fuentio fetched this company.)

    Show the answer (JSON, trimmed)
    {
      "data": {
        "company_id": "FR-SIREN-441639465",
        "name": "RENAULT",
        "snapshots": [
          {
            "valid_from": "2026-10-11T09:59:44.395687+00:00",
            "provenance": {
              "source": "fr_recherche_entreprises",
              "source_url": "https://recherche-entreprises.api.gouv.fr/search?q=Renault&page=1&per_page=10",
              "fetched_at": "2026-10-11T09:59:44.395687Z"
            },
            "changes": []
          },
          {
            "valid_from": "2026-10-11T04:50:43.606488+00:00",
            "provenance": {
              "source": "fr_recherche_entreprises",
              "source_url": "https://recherche-entreprises.api.gouv.fr/search?q=Renault&page=1&per_page=10",
              "fetched_at": "2026-10-11T04:50:43.606488Z"
            },
            "changes": []
          }
        ]
      },
      "meta": {
        "history_since": "2026-10-05",
        "history_note": "History starts the first time Fuentio fetched this company.",
        "total": 4
      }
    }

    Why this matters You see where the history starts, so “nothing changed” never hides a gap.

    Recorded on 12 October 2026 from https://api.fuentio.com/mcp.

  5. Asked

    “Find Spanish companies named Telefónica in the BORME.”

    Tool search_companies {"country": "ES", "query": "telefonica"}

    Answer, as returned

    10 of 251 companies matching 'telefonica' in ES (page 1), source: BORME — Boletín Oficial del Registro Mercantil (Sección A). First results: TELEFONICA SA (ES-RMHOJA-M-6164, match 0.95); TELEFONICA TECH SL (ES-RMHOJA-M-32558, match 0.81); TELEFONICA CABLE SA (ES-RMHOJA-M-110013, match 0.80); TELEFONICA INFRA SL (ES-RMHOJA-M-714534, match 0.80); FIBRA TELEFONICA SOCIEDAD ANONIMA (ES-RMHOJA-BI-17116, match 0.80). More: call again with page=2.

    Show the answer (JSON, trimmed)
    {
      "data": [
        {
          "id": "ES-RMHOJA-M-6164",
          "name": {
            "original": "TELEFONICA SA",
            "latin": "TELEFONICA SA",
            "script": "Latn",
            "language": "es"
          },
          "match": {
            "score": 0.95,
            "reasons": [
              "name_normalized_exact"
            ]
          },
          "status": {
            "value": "unknown",
            "original_label": null,
            "as_of": null
          }
        },
        {
          "id": "ES-RMHOJA-M-32558",
          "name": {
            "original": "TELEFONICA TECH SL",
            "latin": "TELEFONICA TECH SL",
            "script": "Latn",
            "language": "es"
          },
          "match": {
            "score": 0.81,
            "reasons": [
              "name_fuzzy"
            ]
          },
          "status": {
            "value": "unknown",
            "original_label": null,
            "as_of": null
          }
        },
        {
          "id": "ES-RMHOJA-M-110013",
          "name": {
            "original": "TELEFONICA CABLE SA",
            "latin": "TELEFONICA CABLE SA",
            "script": "Latn",
            "language": "es"
          },
          "match": {
            "score": 0.8,
            "reasons": [
              "name_fuzzy"
            ]
          },
          "status": {
            "value": "in_liquidation",
            "original_label": "Disolución",
            "as_of": "2013-10-02"
          }
        }
      ],
      "meta": {
        "total": 251,
        "next_page": 2,
        "uncertainty": "Search ranks names; it never decides that two records are the same company. Use resolve_company for that."
      }
    }

    Why this matters Spanish companies can't be looked up by NIF, so search ranks names with a score and its reasons, and never decides for you.

    Recorded on 12 October 2026 from https://api.fuentio.com/mcp.

  6. Asked

    “Do the sources agree on Peugeot SA?”

    Tool verify_company {"country": "FR", "identifier": "552100554"}

    Answer, as returned

    FR data: partial coverage (All French companies in the public Sirene directory, live from the official Annuaire des Entreprises API (refreshed after 7 days).). PEUGEOT SA (FR, SIREN 552100554): unverified, inactive per Annuaire des Entreprises (API Recherche d'entreprises), checked 2026-10-12. Proof FUE-FR-20261012-C8G7R6.

    Show the answer (JSON, trimmed)
    {
      "meta": {
        "entity": {
          "id": "fu_YKN6Z5FT6ER3",
          "records": 2,
          "conflicting_sources": [
            {
              "field": "creation_date",
              "served_from": "fr_recherche_entreprises",
              "competing": [
                "gleif_golden_copy_fr"
              ]
            }
          ]
        },
        "uncertainty": "Sources disagree on: creation_date. The value served follows the source priority (docs/decisions.md ADR-054); every competing value is listed with its source."
      }
    }

    Why this matters When sources disagree you see it, with every competing value kept, never a silent pick.

    Recorded on 12 October 2026 from https://api.fuentio.com/mcp.

  7. Asked

    “Look up Spanish NIF B12345678.”

    Tool lookup_company {"country": "ES", "identifier": "B12345678"}

    Answer, as returned

    invalid_identifier: 'B12345678' has the format of a NIF/CIF but its check digits are wrong. Next step: Spanish tax-ID (NIF/CIF) lookup isn't supported. Search by company name instead: search_companies(country='ES', query='<company name>').

    Why this matters A polite decline with the next step, not a made-up company.

    Recorded on 12 October 2026 from https://api.fuentio.com/mcp.

  8. Asked

    “Who are the directors of Renault?”

    Tool No tool returns people

    Answer, as returned

    There is no tool for that. The server states it in its own tool descriptions:

    Show the answer (JSON, trimmed)
    {
      "tools": 17,
      "lookup_company": "Limits: 1 unit (also a valid ID not found); keyless 20/day. France: insolvency from BODACC since 2008. Spain: BORME acts since 2 January 2009. No person's name in any answer."
    }

    Why this matters Fuentio checks companies only: no person's name in any answer.

    Recorded on 12 October 2026 from https://api.fuentio.com/mcp.

Why Fuentio

  • France and Spain in one schema, through one REST API and one MCP server.
  • Every fact carries its source, its link and its check date; a verification gives a proof code.
  • When sources disagree you see both values, never a silent pick.
  • Honest gaps: every answer says what could not be confirmed.
  • Built for AI agents: works in Claude as a custom connector and in other MCP clients, and is listed on Smithery.

Try it on your companies

Free pilot: 20 companies Read the docs