# API and MCP for companies and buildings in France

> B2B enrichment and unlimited data for your AI, your apps and your agents: companies, executives, buildings and territories, through a REST API and an MCP server. Free during the preview.

Page: https://gabin.ai/en/developers

B2B enrichment with unlimited data: every company, its executives, its establishments, the buildings it occupies or owns and their territory, all linked together. Through a REST API and an MCP server. Free key in one click (GitHub, Google or e-mail link) at https://gabin.ai/en/account/api; documentation: https://docs.gabin.ai.

## The MCP server

Address: `https://mcp.gabin.ai/mcp` (Streamable HTTP). 18 MCP tools, read-only, the same data as the API. Add the address as a connector: the assistant picks the tools by itself. One-click OAuth 2.1 sign-in from Claude and ChatGPT; Claude Code, Cursor, VS Code: OAuth or your API key in an `Authorization: Bearer` header.

Example questions, and the tools the assistant chains:

- “Who occupies 20 rue de la République in Lyon, and who owns the building?” → `geocode_address` → `get_building` → `get_building_companies`
- “Where is company 552 081 317 located, and which premises does it own?” → `get_company` → `list_company_establishments` → `list_company_buildings`
- “In Villeurbanne, buildings with at least 10 dwellings built before 1975, and their managing agent.” → `search_cities` → `advanced_search` → `get_building`

## The REST API

- **Base URL**: `https://api.gabin.ai/v1`
- **OpenAPI 3.1**: https://api.gabin.ai/v1/openapi.json, to import into your client or code generator
- **Envelope**: `{ data, meta }` on every response, total included
- **Pagination**: cursor-based (`meta.page.next_cursor`), up to 100 items per page
- **Errors**: `{ error: { code, message, docs_url } }`, one code per case

A building at 20 rue de la République, Lyon, and the linked companies with their role:

```bash
curl "https://api.gabin.ai/v1/buildings/bdnb-bg-1M1D-U5N1-HH7E/companies?limit=100" \
  -H "Authorization: Bearer $GABIN_API_KEY"
```

## What you build

- **B2B enrichment and CRM**: From a name or a SIREN to a complete profile: activity, headcount, revenue, executives, establishments.
- **Local prospecting by building**: Start from an address or an area: every building, the companies linked to it and their role.
- **Property and energy agents**: Owners, managing agent, co-ownership, sales, permits: everything about the building, right in the conversation.
- **Territory analysis**: Municipalities, IRIS neighbourhoods, departments: prices, rents, population, income, and the companies based there.

## Data coverage

- ≈ 15 M active companies
- ≈ 32 M buildings, across France
- 18 MCP tools, read-only
- €0 during the preview

- **Companies** (SIRENE · RNE): Identity, activity, headcount, revenue and annual accounts, every establishment.
- **Executives** (RNE): Name, month and year of birth, offices held across all their companies.
- **Buildings** (BDNB · land registry files · RNIC): Everything about the building, and its companies: occupant, owner, probable owner, managing agency or managing agent.
- **Parcels** (Cadastre): Section, number, area, outline, and the buildings on it.
- **Addresses** (BAN): Geocoding down to the building, and named places: residences, hospitals, schools.
- **Areas** (INSEE · IGN · DVF): Municipalities, IRIS neighbourhoods, departments, with their property market figures.
- **Multi-criteria search** (POST /v1/search): Companies or buildings in an area, combined filters, total and breakdowns.
- **Vector tiles** (GET /v1/tiles): The layers of the Gabin map, as MVT, for your own map.

## Free during the preview

- **Rate**: 600 units per minute; a request costs one unit, a multi-criteria search five; shared between your keys and your assistants
- **Quota**: 20,000 units per day and per account, reset at midnight UTC
- **Results**: up to 10,000 per query by following the cursors
- **Security**: OAuth 2.1, keys shown once and stored as a SHA-256 fingerprint, revocable in one click
- **Personal data**: public registers only, SIRENE restricted disclosure respected, no contact details (https://gabin.ai/en/privacy)

Full documentation: https://docs.gabin.ai · https://docs.gabin.ai/llms.txt · https://docs.gabin.ai/llms-full.txt
