> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gabin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gabin API and MCP

> French company and real-estate data for the apps and agents you build: companies, officers, buildings, parcels, addresses and zones, in JSON.

Gabin serves French public data on companies and on the buildings they occupy, as a REST API and as an MCP server. You use it to build apps, internal tools or AI agents that need to know **who is where**: which companies occupy or own a building, which buildings a company uses, what is in a zone.

> [card] [Quickstart](https://docs.gabin.ai/quickstart.md)
>
> Create a key and make your first call in two minutes.

> [card] [Connect the MCP server](https://docs.gabin.ai/mcp/connect.md)
>
> Give Claude, ChatGPT, Cursor or Claude Code access to Gabin.

> [card] [Guides](https://docs.gabin.ai/guides/companies.md)
>
> Companies, buildings, zones, advanced search, map tiles.

> [card] [API reference](https://docs.gabin.ai/api-reference/companies/search-companies.md)
>
> Every endpoint, parameter and field (OpenAPI 3.1).

## What the data covers

| Domain | Content | Main source |
| - | - | - |
| Companies | Legal units and establishments, activity (NAF code), legal form, headcount range, registered office | SIRENE (Insee) |
| Officers | Named officers and their mandates, corporate officers, relations between companies | RNE (INPI) |
| Annual accounts | Revenue, net income and balance-sheet items when the company filed them | RNE (INPI) |
| Buildings | Footprint, use, construction year, levels, dwellings, energy class (DPE), linked companies | BDNB (CSTB) |
| Real estate | Transactions (DVF), corporate owners, condominiums, parking, building permits, fiber, planning zones, market figures | Public open data |
| Parcels and addresses | Cadastral parcels, address geocoding to the building at the street number | Cadastre, BAN |
| Zones | Cities, districts (IRIS), departments, boundaries and market figures | Insee, IGN |

The [data page](https://docs.gabin.ai/data.md) lists the sources, how fresh they are and the rules applied to personal data.

## How you access it

* **REST API** at `https://api.gabin.ai/v1`. JSON responses, cursor pagination, an [OpenAPI 3.1 spec](https://api.gabin.ai/v1/openapi.json) you can feed to code generators or to an LLM.
* **MCP server** at `https://mcp.gabin.ai/mcp`. 18 read-only tools that an AI assistant calls on your behalf. See [MCP overview](https://docs.gabin.ai/mcp/overview.md).

Both use the same account, the same limits and the same data. Access is free during the current preview; every call needs a key, see [authentication](https://docs.gabin.ai/authentication.md).

## A first call

```bash theme={null}
curl "https://api.gabin.ai/v1/companies?q=boulangerie&limit=1" \
  -H "Authorization: Bearer $GABIN_API_KEY"
```

```json theme={null}
{
  "data": [
    {
      "siren": "453060733",
      "name": "BOULANGERIE AUX DELICES",
      "naf_code": "10.71C",
      "naf_label": "Boulangerie et boulangerie-pâtisserie",
      "legal_form": "SAS",
      "headquarters": { "postal_code": "93400", "city": "Saint-Ouen-sur-Seine", "…": "…" },
      "gabin_url": "https://gabin.ai/entreprise/boulangerie-aux-delices-453060733"
    }
  ],
  "meta": { "page": { "next_cursor": "eyJ2IjoxLCJvIjox…", "limit": 1 }, "total": 4643, "total_kind": "exact" }
}
```

Every object links back to its public page on gabin.ai (`gabin_url`), where you can check what the API returns.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.