Reevol Source: supplier search

Search, verify and compare 200,000+ global suppliers by brief, HS code or country. Free, no key.

Hosted MCP Server

npx add-mcp 'https://source.reevol.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

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

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}

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

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

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}

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}

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

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

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

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

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"}

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"}

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"}

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"}

For agents acting on behalf of a supplier that is not listed yet: request a Reevol Source listing. Emails a 6-digit code to the address given. No key needed. See "For agents acting on behalf of a supplier" below.

arguments: {"companyName":"MINJI Stone","website":"minjistone.com","email":"sales@minjistone.com","country":"China","mainProducts":"granite setts","hsCodes":["6801"]}

Verify the emailed code. The request then goes to review (an automated check, and a person when needed); the email gets a "you are live" message with the page link once approved. No key needed.

arguments: {"requestId":"clx...","code":"123456"}

Email a fresh verification code for a request still waiting for verification. No key needed.

arguments: {"requestId":"clx..."}

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"]}

How results are ranked

  • Relevance first. search_suppliers ranks by name similarity (an exact company name or website always comes first), match_suppliers_by_brief by semantic fit to the brief blended with the strength of the supplier's public profile. The HS-code, country and similar-supplier lists contain suppliers that match the filter equally and are ordered by profile strength.
  • Catalog completeness counts a little. A supplier that publishes a Reevol Catalog with products, specs, MOQ or lead time and verified certificates gets a small, capped lift. Every factor is open to every plan, free included. It breaks near-ties; it never moves a supplier past a clearly better match.
  • Featured suppliers are on a paid Reevol plan. Among results that are about equally relevant to the query, they come first and carry featured: true. Payment never places a supplier above a clearly better match, never changes what a profile says, and no supplier is removed from results or from the index for not paying. Every read is free, for every supplier.
  • Reevol Verified. When a supplier carries the badge, reevolVerified lists the automated checks Reevol ran (registered company, live website, owner identity, documents on file). It does not rank, says nothing about products or conduct, and its absence says nothing about a supplier.

For agents acting on behalf of a supplier

Acting for a manufacturer or trading company that is not on Reevol Source yet? Request its listing yourself, no key needed. Check first with search_suppliers.

  1. Call request_supplier_listing (or POST /api/v1/listing-requests) with the company name, its own website and an email.
  2. A 6-digit code is emailed to that address (valid 15 minutes). Pass it to verify_supplier_listing with the requestId. resend_supplier_listing_code sends a new one.
  3. A company email is best. An AI-agent mailbox you control (for example *@mail.grokbot.com or *@agentmail.to) is fine, as long as the website is the company's own. Free webmail is not accepted.
  4. A person at Reevol reviews every request. Once it is approved and the page is built, the email on the request gets a "you are live" message with the page link.
  5. The supplier then manages the profile, catalog and buyer inquiries in Reevi at compass.reevol.com.
curl -X POST https://source.reevol.com/api/v1/listing-requests \
  -H 'content-type: application/json' \
  -d '{"companyName":"MINJI Stone","website":"minjistone.com","email":"sales@minjistone.com","country":"China","mainProducts":"granite setts","hsCodes":["6801"]}'
# -> {"requestId":"...","next":"verify_code","message":"A 6-digit code was emailed..."}

curl -X POST https://source.reevol.com/api/v1/listing-requests/{requestId}/verify \
  -H 'content-type: application/json' -d '{"code":"123456"}'

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

Not listed yet? See "For agents acting on behalf of a supplier" above, or use the request form. 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.