For builders

Connect your agent to 200,000+ verified suppliers

Free public MCP server and REST API from Reevol, the Revenue OS for Global Trade, powering the agentic era of global trade. Connect Claude Desktop, ChatGPT, Perplexity, or any HTTP-capable agent to the Reevol Source supplier intelligence platform. 200,000+ verified suppliers across 120+ countries, grounded in public B2B directories, served as a public MCP server and citation-friendly markdown cards.

MCP server

Endpoint: https://source.reevol.com/mcp. Streamable HTTP transport, stateless. Anonymous traffic gets 60 req/min per IP. Mint a free key for 300 req/min and 100,000 req/month, or contact contact@reevol.com for partner / enterprise tiers.

With a key, send the Bearer header on every request: Authorization: Bearer rsk_pub_...

Connect from Claude Desktop

Add to your Claude Desktop MCP config:

{
  "mcpServers": {
    "reevol-source": {
      "url": "https://source.reevol.com/mcp"
    }
  }
}

Connect from a custom agent (raw HTTP)

curl -X POST https://source.reevol.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tools

match_suppliers_by_brief

Best tool when the buyer describes what they need in their own words. Combines semantic search (Voyage embeddings) with structured filters (country, HS codes, certifications, employee range, year founded, business type, export markets). Returns ranked supplier cards each with a matchExplanation.

arguments: {"brief":"BSCI-certified Vietnam factory for women's woven outerwear, 11-50 staff, exports to EU","country":"Vietnam","certifications":["BSCI"],"employeeRange":["11-50","51-200"],"limit":10}

search_suppliers

Find suppliers by company name, brand, or alias. Returns ranked supplier cards.

arguments: {"query":"shenzhen ksy","limit":5}

find_suppliers_by_hs_code

List suppliers that manufacture or trade goods under a given HS code, with optional country / certifications / employee range / business type filters.

arguments: {"hsCode":"8471","country":"China","certifications":["ISO 9001"],"limit":10}

find_suppliers_by_country

List suppliers headquartered in a country, with optional industry / certifications / employee range / business type filters.

arguments: {"country":"Vietnam","industry":"Electronics","employeeRange":["51-200"],"limit":10}

get_supplier

Fetch a full supplier profile by slug: identity, location, HS codes, certifications, trade fairs, summary, FAQ.

arguments: {"slug":"shenzhen-ksy","lang":"en"}

get_similar_suppliers

Given one supplier slug, return up to 10 similar suppliers in the same industry and country.

arguments: {"slug":"shenzhen-ksy","limit":10}

compare_suppliers

Side-by-side comparison of 2-4 suppliers: identity, location, certifications, trade-fair count, employees, founded, HS overlap, shared signals. Read-only, no key required.

arguments: {"slugs":["shenzhen-ksy","dongguan-acme"],"lang":"en"}

get_red_flags

Structured due-diligence signals for one supplier (missing data, certification freshness, data completeness, enrichment staleness). Structural language only. Partner / enterprise key required.

arguments: {"slug":"shenzhen-ksy"}

draft_rfq

Generate an RFQ email body grounded in supplier facts + buyer brief. Bilingual EN+zh for China-region suppliers. Nothing is sent. Partner / enterprise key required.

arguments: {"slug":"shenzhen-ksy","brief":"5000 units USB-C cables, USB-IF certified","quantity":"5000"}

request_introduction

Submit a buyer introduction request. Verified suppliers get a direct intro; unclaimed suppliers are brokered through Reevol managed sourcing. Partner / enterprise key required.

arguments: {"slug":"shenzhen-ksy","buyerEmail":"buyer@acme.com","briefSnippet":"Sourcing USB-C cables, 5000 units/month"}

find_and_brief

One-shot deep research: shortlist, a structural dossier with due-diligence signals per supplier, an AI-synthesized comparison grounded strictly in that data, and a recommended next step. Non-streaming (returns the full result). Cached 24h on identical brief + filters. Partner / enterprise key required.

arguments: {"brief":"BSCI-certified Vietnam factory for women's woven outerwear, 11-50 staff","country":"Vietnam","certifications":["BSCI"]}

Deep research

One call does what a buyer would otherwise orchestrate by hand: shortlist, a structural dossier with due-diligence signals per supplier, an AI-synthesized comparison grounded strictly in that data, and a recommended next step. Results are cached for 24 hours on an identical brief and filters, so repeated calls are cheap and citations stay stable. Partner / enterprise key required.

Streaming (SSE)

curl -N -X POST https://source.reevol.com/mcp/deep \
  -H 'authorization: Bearer rsk_...' \
  -H 'content-type: application/json' \
  -d '{"brief":"BSCI-certified Vietnam factory for women'"'"'s woven outerwear, 11-50 staff","country":"Vietnam","certifications":["BSCI"]}'
# SSE events: shortlist -> dossier (xN) -> comparison -> next_step -> done

Non-streaming

If your agent can't consume SSE, use the find_and_brief MCP tool, or POST the same body to /api/v1/suppliers/deep-research and get the full result back.

Citation-friendly supplier cards

Every supplier profile is also available as machine-readable markdown:

GET https://source.reevol.com/{locale}/suppliers/{slug}/ai-card.md
locales: en, zh-CN, es, pt-BR, fr, ar
example: https://source.reevol.com/en/suppliers/shenzhen-ksy/ai-card.md

The markdown card is the canonical citation surface: facts only, no marketing copy, provenance labels intact. LLMs quote markdown more reliably than scraped HTML.

Client libraries

Prefer an SDK to raw HTTP? We ship open-source clients: a Python SDK (pip install reevol-source), a LangChain retriever, an n8n node, and a ready-to-publish ChatGPT Custom GPT. See /for-agents/clients/ or github.com/40Seas/reevol-source-clients.

Suppliers

Suppliers manage their Reevol Source presence through Reevi. Edits made in Reevi propagate to Source profiles and to the MCP responses on the next cache refresh.

Building something with Reevol Source? We share early access to the REST API, custom rate limits, and roadmap input with active partners. Reach out to contact@reevol.com with a one-line description of your agent and an estimate of monthly query volume.

See also: llms.txt, sitemap, methodology.