Reevol Source: supplier search

Find suppliers by company name (English or Chinese), brand, or alias. Returns ranked supplier cards. Use this when a buyer mentions a supplier by name or asks 'who is X?'.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Company name, brand, or alias. Min 2 chars."
    },
    "limit": {
      "description": "Max results, default 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "lang": {
      "description": "Locale for the returned URLs (en, zh-CN, es, pt-BR, fr, ar). Default en.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List suppliers that manufacture or trade goods under a given Harmonized System code, with optional structured filters. Use this when a buyer asks 'find me a supplier for HS code 8473.30' or 'who makes [HS-described product]'.

{
  "type": "object",
  "properties": {
    "hsCode": {
      "type": "string",
      "minLength": 2,
      "maxLength": 12,
      "description": "Full or partial HS code (2-12 digits). E.g. \"8473.30\" or \"847330\"."
    },
    "country": {
      "description": "Canonical country name (e.g. \"China\", \"Vietnam\"). Optional.",
      "type": "string"
    },
    "certifications": {
      "description": "Certification names to require (any-of). E.g. [\"ISO 9001\",\"BSCI\"].",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "employeeRange": {
      "description": "Employee bands to allow. E.g. [\"1-10\",\"11-50\",\"51-200\",\"201-500\",\"500+\"].",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "businessType": {
      "description": "Restrict to manufacturer vs trading company.",
      "type": "string",
      "enum": [
        "manufacturer",
        "trading_company",
        "any"
      ]
    },
    "limit": {
      "description": "Max results, default 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "lang": {
      "description": "Locale for the returned URLs. Default en.",
      "type": "string"
    }
  },
  "required": [
    "hsCode"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List suppliers headquartered in a given country, optionally filtered by industry, certifications, employee range, or business type. Ordered by visibility score.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "Canonical country name, e.g. \"China\", \"Vietnam\", \"Turkey\"."
    },
    "industry": {
      "description": "Primary industry filter (matches Reevol industry taxonomy).",
      "type": "string"
    },
    "certifications": {
      "description": "Certification names to require (any-of). E.g. [\"ISO 9001\",\"BSCI\"].",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "employeeRange": {
      "description": "Employee bands to allow. E.g. [\"1-10\",\"11-50\",\"51-200\",\"201-500\",\"500+\"].",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "businessType": {
      "description": "Restrict to manufacturer vs trading company.",
      "type": "string",
      "enum": [
        "manufacturer",
        "trading_company",
        "any"
      ]
    },
    "limit": {
      "description": "Max results, default 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "lang": {
      "description": "Locale for the returned URLs. Default en.",
      "type": "string"
    }
  },
  "required": [
    "country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Best tool when a buyer describes what they need in their own words. Combines semantic search (Voyage embeddings over supplier industry, HS codes, certifications, trade-fair history, and the EN summary) with structured filters (country, HS codes, certifications, employee range, year founded, business type, export markets). Returns a ranked list of supplier cards, each with a `matchExplanation` summarizing why it surfaced. Example brief: 'BSCI-certified Vietnam factory for women's woven outerwear, MOQ-flexible, 11-50 staff, exports to EU'.

{
  "type": "object",
  "properties": {
    "brief": {
      "type": "string",
      "minLength": 8,
      "maxLength": 2000,
      "description": "Freeform description of what the buyer is sourcing."
    },
    "country": {
      "description": "Single canonical country name.",
      "type": "string"
    },
    "countries": {
      "description": "Multi-country allow-list. Takes precedence over `country`.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "excludeCountries": {
      "description": "Country deny-list.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "hsCodes": {
      "description": "Any-of HS codes (2-12 digits each).",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "industry": {
      "description": "Primary industry filter.",
      "type": "string"
    },
    "certifications": {
      "description": "Any-of certification names. E.g. [\"ISO 9001\",\"BSCI\",\"GOTS\"].",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "employeeRange": {
      "description": "Allowed employee bands.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "foundedAfter": {
      "description": "Minimum year founded.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "foundedBefore": {
      "description": "Maximum year founded.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "businessType": {
      "type": "string",
      "enum": [
        "manufacturer",
        "trading_company",
        "any"
      ]
    },
    "exportMarkets": {
      "description": "Any-of canonical export-market names.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "limit": {
      "description": "Max results, default 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "lang": {
      "description": "Locale for the returned URLs. Default en.",
      "type": "string"
    }
  },
  "required": [
    "brief"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch a full supplier profile by slug: identity, location, HS codes, certifications, trade fairs, export markets, and the AI-generated buyer-facing summary + FAQ. Use after search_suppliers to dig into a specific match. When the supplier publishes a Reevol Catalog, a `catalog` block adds its products, certificates, key facts and catalog URL (plus the catalog's own MCP endpoint), and the supplier can be contacted directly with request_introduction, no key needed.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Supplier slug, e.g. \"shenzhen-acme-electronics-co-ltd\"."
    },
    "lang": {
      "description": "Locale for the summary + FAQ (en, zh-CN, es, pt-BR, fr, ar). Default en.",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Given one supplier slug, return up to 10 similar suppliers in the same industry and country. Use to answer 'what are alternatives to X?' or 'who else makes similar products in [country]?'.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Reference supplier slug."
    },
    "limit": {
      "description": "Max results, default 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "lang": {
      "description": "Locale for the returned URLs. Default en.",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Side-by-side comparison of 2-4 suppliers by slug: identity, location, certifications, trade-fair count, employee range, year founded, HS code overlap, and visibility. Read-only, no key required. Returns shared signals (common HS codes / certifications / country) so you can summarize the trade-offs for a buyer.

{
  "type": "object",
  "properties": {
    "slugs": {
      "minItems": 2,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 200
      },
      "description": "2-4 supplier slugs to compare."
    },
    "lang": {
      "description": "Locale for the returned URLs. Default en.",
      "type": "string"
    }
  },
  "required": [
    "slugs"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Structured due-diligence scan for one supplier: missing data, certification freshness, trade-fair recency, data completeness, and enrichment staleness. Structural signals only, never an accusation or credit judgment. Requires a partner or enterprise key.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "lang": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Generate a professional RFQ (request for quotation) email body grounded in the supplier's facts and the buyer's brief. Returns the draft text only; nothing is sent. Chinese-region suppliers get a bilingual EN+zh draft. Requires a partner or enterprise key.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "brief": {
      "type": "string",
      "minLength": 8,
      "maxLength": 2000,
      "description": "What the buyer wants to source."
    },
    "buyerCompany": {
      "type": "string"
    },
    "quantity": {
      "description": "Target order size / quantity, free text.",
      "type": "string"
    }
  },
  "required": [
    "slug",
    "brief"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Submit a buyer's interest in a specific supplier. If get_supplier returned a `catalog` block, the supplier takes inbound buyers directly: the request lands in the supplier's own inbox on Reevol and they reply by email. That path is open to every agent, no key needed; pass the buyer's real name and email and a specific brief (products, quantities, destination). For other suppliers it creates a lead that Reevol routes (verified suppliers get a direct intro, unclaimed ones go through Reevol managed sourcing), and that path requires a partner or enterprise key.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "buyerEmail": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Buyer contact email for the introduction."
    },
    "briefSnippet": {
      "type": "string",
      "minLength": 8,
      "maxLength": 2000,
      "description": "What the buyer wants to source / why they want the intro."
    },
    "buyerName": {
      "type": "string"
    },
    "buyerCompany": {
      "type": "string"
    }
  },
  "required": [
    "slug",
    "buyerEmail",
    "briefSnippet"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

One-shot deep research. Runs the full pipeline in a single call: shortlist (semantic + structured match), a structural dossier with due-diligence signals per supplier, an AI-synthesized comparison grounded strictly in that data, and a recommended next step. Returns the complete result (non-streaming) — use this when your agent cannot consume the /mcp/deep SSE stream. Results are cached for 24h on identical brief + filters, so repeated calls are cheap and citations are stable. Requires a partner or enterprise key.

{
  "type": "object",
  "properties": {
    "brief": {
      "type": "string",
      "minLength": 8,
      "maxLength": 2000,
      "description": "Freeform description of what the buyer is sourcing."
    },
    "country": {
      "type": "string"
    },
    "countries": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "excludeCountries": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "hsCodes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "industry": {
      "type": "string"
    },
    "certifications": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "employeeRange": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "foundedAfter": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "foundedBefore": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "businessType": {
      "type": "string",
      "enum": [
        "manufacturer",
        "trading_company",
        "any"
      ]
    },
    "exportMarkets": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "lang": {
      "type": "string"
    }
  },
  "required": [
    "brief"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}