API and MCP server

The same data as the company pages, for your programs and AI agents: identity, establishments, directors, accounts and ratios, legal notices, dated changes. One key works for both.

Get a key

1. Open an account with your email address: a sign in link is sent to you, no password needed.
2. In your account, create a key and copy it right away: it will not be shown again.
3. Send it in the Authorization: Bearer <key> header, for the API and the MCP server alike.

Create an account and a key

The free plan

30 calls per minute, 1,000 calls per month, 20 results per page. For higher volumes, write to contact@corporary.com.

REST API

JSON responses, rate limits announced in headers. The full documentation, generated from the code, is in the OpenAPI documentation.

• GET /api/v1/search?q= : search by name, SIREN, city or director
• GET /api/v1/fr/companies/{siren} : company identity
• GET /api/v1/fr/companies/{siren}/establishments, /officers, /finances, /announcements, /scores
• GET /api/v1/changes?since= : every change since a date

MCP server

Address: https://corporary.com/mcp, HTTP transport, authenticated with the same key. Seven tools: search_companies, get_company, get_financials, get_changes, get_group, get_attachments and get_score.

Configuration for Claude Code, Cursor and VS Code:

Claude Code

claude mcp add --transport http corporary https://corporary.com/mcp --header "Authorization: Bearer YOUR_KEY"

Cursor (.cursor/mcp.json)

{
    "mcpServers": {
        "corporary": {
            "url": "https://corporary.com/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_KEY"
            }
        }
    }
}

VS Code (.vscode/mcp.json)

{
    "servers": {
        "corporary": {
            "type": "http",
            "url": "https://corporary.com/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_KEY"
            }
        }
    }
}

The server authenticates with a key, not OAuth: it works in clients that accept a custom header, not yet as a connector in web apps that require OAuth.

Use of the API and MCP server is subject to the terms of use. Reused data stays under the licence of its producer, shown on the methodology page.