How to Use the Pappers MCP in Windsurf

Q: How do I search French companies with the Pappers MCP integration inside Windsurf?

You ask Cascade to find a company. It uses searchfrenchcompanies to query the registry, then automatically pulls details with getfrenchcompanydetails if you need deeper data.

Q: Can Windsurf automatically pull financial documents using Pappers?

Yes. Cascade uses getcompanydocument to download official PDFs like the Articles of Association directly into your project directory.

Q: How does the Pappers MCP Server handle rate limits in Windsurf?

The server monitors your usage via getapiaccountinfo. If you approach your limit, Cascade can adjust its query speed to prevent failures.

Run complex French corporate due diligence chains autonomously in Windsurf using Cascade.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Pappers MCP to Windsurf

Create your Vinkius account to connect Pappers to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Pappers with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Map French corporate webs with Windsurf

The `search_ultimate_beneficial_owners` tool exposes the actual individuals behind complex French corporate structures through this MCP Server. Cascade chains this with `search_company_officers` to build a complete profile of directors and shareholders without manual intervention. You do not need to prompt each step. Give Cascade a company name and it runs the search, identifies the owners, and lists their other corporate interests in one execution loop.

Deep financial audits in one Cascade run

The `get_company_financials` tool pulls raw balance sheets and income statements directly into your workspace. Cascade analyzes these numbers to flag sudden revenue drops or debt spikes automatically. It retrieves official records using `get_company_document` to cross-reference filings. You get a clean markdown summary of the company's financial health without opening a browser.

Real-time French registry monitoring via MCP Server

The `list_monitored_companies` tool tracks status changes across your target list. If a company files for bankruptcy, Cascade catches the update and alerts you. It uses `list_bodacc_publications` to monitor official French state announcements. This keeps your compliance records updated without manual registry checks.

Setup guide

Set up Pappers MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Pappers MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Pappers payment history." If connected, Cascade will call the Pappers tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "pappers-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Pappers. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Pappers now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Pappers MCP in Windsurf

You ask Cascade to find a company. It uses `search_french_companies` to query the registry, then automatically pulls details with `get_french_company_details` if you need deeper data.

Yes. Cascade uses `get_company_document` to download official PDFs like the Articles of Association directly into your project directory.

The server monitors your usage via `get_api_account_info`. If you approach your limit, Cascade can adjust its query speed to prevent failures.

No. The server routes all requests through the official API, meaning you get instant global access to French registry data from anywhere.

All queries to the French business registry pass through an isolated V8 sandbox. Your API keys and company search histories are never stored or shared.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript