# Pappers MCP > Pappers MCP Server gives your agent direct access to French corporate records. Need due diligence? Use this server to pull legal documents, financial filings, and official company details (SIREN/SIRET) from France's business registries. You can search by name, track officer changes, monitor Ultimate Beneficial Owners (UBOs), and get key metrics like turnover—all through natural chat commands. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** company-data, due-diligence, financial-filings, corporate-research, siren-siret, public-records ## Description This server gives your agent direct access to French corporate records via Pappers' APIs. Don't switch tabs between government websites and spreadsheets; you get all the legal structure, financial metrics, and compliance data right in your chat window. Finding a company starts with broad searches. You run `search_french_companies` using criteria like name, NAF code, or location to pinpoint a target entity. As you type, the agent provides suggestions through `get_search_suggestions`, helping you nail down the exact search parameters. Once you have the core identity, you can pull comprehensive, high-level data for that French corporate entity by calling `get_french_company_details`. If you need to know about a specific branch or registered physical location, run `get_establishment_details`. To understand who runs and owns the company, you check leadership records. Use `search_ultimate_beneficial_owners` to identify all individuals who ultimately own or control the entity. To map out the entire management structure, call `search_company_officers`; this lists every registered director and manager, current or former. When it comes to finance and legal standing, you have specific tools at your disposal. You pull hard financial numbers—like turnover and net income—by calling `get_company_financials`. To access official corporate records, such as Articles of Association, the agent uses `get_company_document` to retrieve them. For staying current on regulatory changes, you list recent publications from BODACC using `list_bodacc_publications`. For tracking status and monitoring key players, you can use `list_monitored_companies` to see which companies your account is actively watching for changes. You'll also get general details about your connected Pappers account with `get_api_account_info`, and you can verify the service's operational health anytime by running `check_api_health`. This server handles all that tedious research grunt work so you don't have to. ## Tools ### check_api_health Verifies the current operational status of the Pappers API service. ### get_api_account_info Retrieves general details about your connected Pappers account. ### get_french_company_details Gets comprehensive, high-level data for a French corporate entity. ### get_company_document Accesses specific legal documents, like Articles of Association, for a company. ### get_establishment_details Retrieves specific operational details about one of a company's registered physical locations or branches. ### get_company_financials Pulls key financial data points (turnover, net income) for a specified French company. ### get_search_suggestions Provides autocomplete suggestions as you type names or criteria into the search query. ### list_bodacc_publications Searches and lists official publications from BODACC, keeping you current on corporate events. ### list_monitored_companies Displays the list of companies that your account is actively monitoring for status changes. ### search_french_companies Performs broad searches to find French companies using criteria like name, NAF code, or location. ### search_company_officers Searches and lists all current or former directors and managers associated with a company. ### search_ultimate_beneficial_owners Searches for and identifies the ultimate beneficial owners linked to a company. ## Prompt Examples **Prompt:** ``` Search for companies named 'Vinkius' in France. ``` **Response:** ``` I've found 1 company matching 'Vinkius' in Paris (SIREN: 123456789). Would you like me to retrieve the list of directors or the latest financial statements? ``` **Prompt:** ``` Look up the financial details and legal status of the French company with SIREN 443061841. ``` **Response:** ``` Company found: Pappers SAS (SIREN: 443061841). Registered in Paris, active since 2002. Legal form: SAS (Simplified Joint Stock Company). Capital: EUR 150,000. Last published revenue: EUR 2.8M (2024). Current directors: 2 listed executives. No legal proceedings or insolvency filings on record. NAF code: 6311Z (Data processing). ``` **Prompt:** ``` Search for all companies in the Lyon area that operate in the software development sector. ``` **Response:** ``` Found 342 active software companies in the Lyon metropolitan area (code NAF 6201Z). 89 were created in the last 2 years. Top 5 by revenue: "Axway Software" (EUR 298M), "Esker SA" (EUR 178M), "Cegid Group" (EUR 156M), "Bonitasoft" (EUR 12M), and "Hardis Group" (EUR 9.4M). Average company age: 8.7 years. ``` ## Capabilities ### Search for French Companies The agent finds a company's core identity by running `search_french_companies` using criteria like name, location, or NAF code. ### Retrieve Financial Metrics You pull specific financial data—turnover, net income, etc.—by calling the `get_company_financials` tool. ### Identify Ultimate Beneficial Owners (UBO) The agent executes `search_ultimate_beneficial_owners` to find and list individuals who ultimately own or control a target company. ### Find Directors and Officers You get the current leadership structure by using `search_company_officers`, listing all registered directors and managers. ### Access Legal Documents The agent pulls official corporate records, such as Articles of Association, via the `get_company_document` tool. ### Monitor Company Status You maintain lists and check status updates using tools like `list_monitored_companies` or checking API health with `check_api_health`. ## Use Cases ### Vetting a new B2B prospect. A sales analyst needs to vet a French target. They prompt the agent: 'What's their money situation and who runs it?' The agent first uses `get_company_financials` for turnover, then runs `search_ultimate_beneficial_owners`. In seconds, they know if the company is financially stable and who actually signs the checks. ### Investigating a corporate change. A compliance officer notices a key executive left. They ask the agent to check leadership changes for SIREN 123456789. The agent uses `search_company_officers` and can immediately pull up the full list of current directors, confirming who is in charge now. ### Building a market map. A researcher needs to find all software developers near Lyon. They use `search_french_companies`, filtering by location and NAF code 6201Z. The agent returns the list, along with average company age data, allowing them to build a targeted outreach list. ### Reviewing legal structure. A law firm client needs to confirm the exact founding documents of a target entity. They prompt for 'the Articles of Association' and the agent uses `get_company_document` to retrieve the official filing, eliminating guesswork about corporate history. ## Benefits - **Check Financial Health Instantly:** Instead of navigating separate financial portals, you call `get_company_financials` and pull key metrics—like last published revenue or turnover—directly into your conversation thread. This is critical for quick B2B lead qualification. - **Full Ownership Trail:** You eliminate the ambiguity of ownership by using `search_ultimate_beneficial_owners`. The agent runs this tool to pinpoint who actually controls a company, skipping layers of shell corporations. - **Governance Monitoring:** Keep track of leadership changes with `search_company_officers`. This tool lists all directors and managers, letting you monitor corporate governance shifts without manually checking multiple registries. - **Document Access on Demand:** Need the legal structure? Call `get_company_document` to access Articles of Association. It pulls the exact legal text you need, saving hours of manual PDF downloading and reading. - **Deep Search Capability:** Don't just search by name. Use `search_french_companies` with NAF codes or specific locations to narrow down your market research to exactly what you need. - **Stay Compliant:** Monitor official corporate changes using `list_bodacc_publications`. This tool ensures you see mandatory, real-time public filings that affect due diligence. ## How It Works The bottom line is, you get to treat Pappers' complex database like a single, natural conversation with your agent. 1. 1. Subscribe to the Pappers MCP Server and provide your unique Pappers API Key in the client settings. 2. 2. Prompt your agent (Claude, Cursor, etc.) with a specific query: 'Get financials for company X.' 3. 3. The server runs the necessary tool(s) (e.g., `get_company_financials`) and returns structured data that your AI client interprets and presents in plain language. ## Frequently Asked Questions **How do I search for all companies in France with Pappers MCP Server?** You use `search_french_companies`. You can narrow the results by name, location (like Lyon), or NAF code to get a highly targeted list of businesses. **What is the difference between `get_company_details` and `get_establishment_details`?** `get_french_company_details` gives you the macro view—the overall corporate entity. `get_establishment_details` focuses on a physical branch or specific operational site connected to that main company. **Can I find out who owns a company using search_ultimate_beneficial_owners?** Yes, that's the tool for it. `search_ultimate_beneficial_owners` pulls the names of the people or entities that ultimately control the corporate structure. **What if I need to monitor changes in a company's legal filings?** Use `list_bodacc_publications`. This tool searches official BODACC records, so you don’t miss any mandatory public announcements about the company's status. **Does Pappers MCP Server handle financial data retrieval? (get_company_financials)** Yes. `get_company_financials` pulls key metrics like turnover and net income, which is essential for quickly assessing a prospect's financial health. **Before I start querying, how do I validate my setup using `get_api_account_info`?** This tool confirms your subscription status and provides core account details. It's the first step to ensure your AI client has valid credentials before making any corporate data calls. **What specific kind of personnel information does `search_company_officers` retrieve?** It finds current company directors and managers, providing their names and roles. This tool focuses on operational leadership within the firm, distinguishing it from UBOs. **Does calling `get_search_suggestions` help improve overall search performance for companies?** Yes, using this tool gives you autocomplete suggestions based on partial input. It helps narrow down your query scope quickly and improves the accuracy of your initial company identification. **Can my AI automatically find the financial details for a company by its SIREN?** Yes! Use the `get_company_financials` tool with the 9-digit SIREN. Your agent will respond with complete metadata, including turnover, profit, and debt ratios in seconds. **How do I find my Pappers API Key?** Log in to your Pappers account, navigate to the [**API Subscription**](https://www.pappers.fr/api) page, and you will find your unique secret token there. **Does this work for international companies?** This MCP server specifically targets the Pappers France API. For international European company data, Pappers provides a separate API (pappers.in).