--- name: resolve402 description: Find who runs a French company (CEO, président, gérant, DG) with a probable business email, list decision makers by sector and place, check a company before invoicing or paying it (status, VAT, insolvency, sanctions, IBAN), get the contact details a company publishes on its own site (shared emails, phones, address, verified legal identifiers), see whether any company is hiring, pre-check an email, and convert documents (PDF, DOCX, HTML, images to Markdown; Markdown to PDF). Paid per call, not found = not charged. --- # Resolve402 Base URL: https://resolve402.dev · OpenAPI: https://resolve402.dev/openapi.json · Guide: https://resolve402.dev/llms.txt ## Setup - With an x402 wallet (AgentCash, Coinbase CDP, Keyban Agent Wallet, x402-fetch): nothing to install, call the URLs below and pay the 402. - As MCP tools: `npx -y resolve402-mcp` (needs an x402 wallet key in the MCP config). ## Tools 1. Decision makers — GET https://resolve402.dev/api/decision-makers?siren=<9 digits> | ?company= [&domain=] — $0.02. MCP tool: find_decision_makers. Returns officers from the official RNE registry, company domain, mail provider, and per officer a probable email {address, pattern, pattern_source, confidence, verified:false}. pattern_source "observed_on_site" (pattern seen on the company's own public pages, confidence medium/high) beats "default_fr" (guess, confidence low). 2. People search — GET https://resolve402.dev/api/people-search?role=ceo|president|dg|gerant|any_executive§or=&department=|region=|postal_code=<5 digits>&min_employees=[&min_revenue=5M&max_revenue=&min_net_income=0&max_net_income=&keywords=&limit=10&page=1] — $0.05. MCP tool: people_search. Up to 25 decision makers of matching French companies (official registry). Call decision makers on the ones you keep for emails. 3. Counterparty check — GET https://resolve402.dev/api/counterparty-check?siren=<9 digits> | ?siret= | ?vat= | ?company= [&iban=] — $0.02. MCP tool: counterparty_check. Before invoicing or paying: active, VAT valid (VIES), insolvency (BODACC), sanctions on the company and its officers (DG Trésor, EU consolidated list, OFAC SDN), IBAN. Verdict ok / review / block: on review or block, ask a human. 4. Company contacts — GET https://resolve402.dev/api/company-contacts?domain= | ?url= — $0.005. MCP tool: company_contacts. What the company publishes on its own site: shared emails only (contact@, press@, dpo@; personal ones only counted), phones in E.164 with type, head-office address, social pages, contact form, legal identifiers checked (SIREN Luhn, VAT checksum, RCS, Impressum register) and matched to the French registry (siren_match). Each field has its source page. 5. Hiring signals — GET https://resolve402.dev/api/hiring-signals?domain= | ?siren=<9 digits> | ?company= [&limit=50] — $0.01. MCP tool: hiring_signals. Open jobs from the public ATS board, hiring_intent, by_function. Chain with decision makers. 6. Email pre-check — GET https://resolve402.dev/api/verify-email?email=
— $0.003. MCP tool: verify_email. Score 0-100 with reasons (syntax, MX, provider, SPF, DMARC, disposable, webmail, role account, random-looking). No mailbox test: smtp_check:false, accept_all:null, max 90. 7. Document to Markdown — GET https://resolve402.dev/api/doc-to-markdown?url= | POST https://resolve402.dev/api/doc-to-markdown (multipart file field, or raw binary body) — $0.005. MCP tool: doc_to_markdown. Clean Markdown with tables as rows, OCR (French, English) for scanned PDFs and images. Charged only if text is found. 8. Markdown to PDF — POST https://resolve402.dev/api/markdown-to-pdf with JSON {markdown, title?, paper?: "A4"|"Letter"} (or a text/markdown body with ?title=&paper=) — $0.01. MCP tool: markdown_to_pdf. A clean application/pdf (headings, lists, code, tables, page numbers) from Markdown, max 200k characters. 9. Company search by NACE code — GET https://resolve402.dev/api/company-search?country=FR|NO|FI&nace=[&nace_rev=2|2.1®ion=&size_min=&size_max=&status=active|all&limit=1-25] — $0.01. MCP tool: company_search. Companies whose MAIN activity is the NACE code you give (Rev. 2 or 2.1, class, group or division), from the official registers of France, Norway and Finland, with both NACE codes, the local code, status, size band and the registry licence; sole traders never returned. ## Rules - 404 means not found and is not charged. Do not retry a 404 with the same input. - Emails are probable, not SMTP-verified: say so to the user, use email_alternatives when confidence is low. - France only for decision makers and people search. Nothing is stored. Opt-out: POST https://resolve402.dev/api/opt-out. ## Example GET https://resolve402.dev/api/decision-makers?siren=552032534 → Danone officers with firstname.lastname@danone.com patterns.