Servidor MCP

buyer-intelligence

io.github.tonyback0101-cmyk/buyer-intelligence
Comercio y retail Ventas y CRM Público y accesible MCP 2026-07-28

Qué hace este MCP

Discovers verified B2B buyers and suppliers, enriches buyer contacts, manages quote requests, and supports supplier-quote-based ordering.

analyze_buyer_intelligence
Deep company intelligence for a buyer: corporate registry verification, customs import records, supply chain mapping, decision-maker profiling, risk flags. Returns 0-100 score with evidence chain.
Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['target_domain'], 'properties': {'country_iso': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code'}, 'target_domain': {'type': 'string', 'description': "Buyer's website domain"}, 'target_company_name': {'type': 'string', 'description': "Buyer's company name"}}}
check_discovery_task
Poll a background buyer-discovery task created by find_buyers (acquisition.task_id) or submit_discovery_job. Returns status (working | completed | failed); when completed, includes the freshly gathered buyers. Use exponential backoff (start ~20s) and stop polling once status is completed or failed. Free.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['task_id'], 'properties': {'limit': {'type': 'number', 'description': 'Max buyers to return when completed (default 50, max 100)'}, 'task_id': {'type': 'string', 'description': "The task_id returned in find_buyers' acquisition field, or a discovery job_id"}}}
create_payment_mandate
Create an AP2 payment mandate: a pre-authorization that lets your agent place orders autonomously (human-not-present) within strict limits — total budget, optional per-order cap, currency, optional seller/category scope, and expiry. Returns a mandate_id to pass to place_order. Each order authorized against it is recorded as a verifiable intent and decrements the budget. Requires authentication.
Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['max_total_amount'], 'properties': {'currency': {'type': 'string', 'description': 'Currency, e.g. USD (default USD). Must match the order currency to authorize.'}, 'expires_at': {'type': 'string', 'description': 'Optional ISO timestamp after which the mandate is no longer valid.'}, 'seller_scope': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional list of allowed seller_user_id UUIDs. Omit = any seller.'}, 'category_scope': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional list of allowed category codes (mall_category_code). Omit = any category.'}, 'max_total_amount': {'type': 'number', 'description': 'Total spend budget for this mandate (required, > 0)'}, 'max_per_order_amount': {'type': 'number', 'description': 'Optional per-order cap'}}}
enrich_buyer_contact
Run 6-layer contact enrichment for a buyer: direct website scraping → proxy retry → BFS contact pages → LLM text extraction → vision screenshot → Serper fallback. Returns email, phone, WhatsApp, decision-maker names. Costs Zhimao Points.
Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['target_domain'], 'properties': {'target_domain': {'type': 'string', 'description': "Buyer's website domain (e.g. 'example-importer.com')"}, 'target_company_name': {'type': 'string', 'description': "Buyer's company name"}}}
find_buyers
Search 500,000+ verified importers and distributors by product category and target country. Returns company profiles + a `coverage` object. When in-database coverage is thin (empty/partial), the response includes an `acquisition` task (task_id) — a background crawl is started automatically (free). Poll it with check_discovery_task until status=completed to get freshly gathered buyers. Contact details are not included — use enrich_buyer_contact to get them.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['category'], 'properties': {'limit': {'type': 'number', 'description': 'Max results to return (default 20, max 100)'}, 'category': {'type': 'string', 'description': "Product category (e.g. 'flour', 'stainless steel tableware', 'LED lighting')"}, 'country_iso': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code (e.g. MY, ID, KE, AE, GB)'}, 'quality_grade': {'enum': ['premium', 'qualified'], 'type': 'string', 'description': "Filter by data quality. 'premium' = verified contact + multi-source evidence."}}}
list_group_buy_pools
List open collective sourcing projects (联拼宝 / Lianpinbao). Multiple suppliers co-sell into shared buyer pools, reducing per-supplier MOQ. Find pools where you can join to access existing buyer demand.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'status': {'enum': ['open', 'filling'], 'type': 'string', 'description': 'Pool status (default: open)'}, 'category': {'type': 'string', 'description': 'Filter by product category keyword (optional)'}}}
list_payment_mandates
List your AP2 payment mandates with status, currency, total/per-order limits, consumed and remaining budget, scope and expiry. Requires authentication.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'properties': {}}
list_quotes
List the supplier quotes submitted for one of your inquiries (from request_quote). Returns each quote's id, unit price, total, MOQ, lead time and validity, plus acceptable_quote_ids you can pass to place_order. Requires authentication; only the inquiry's buyer (or the product's supplier) may read it.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['inquiry_id'], 'properties': {'inquiry_id': {'type': 'string', 'description': 'The inquiry_id returned by request_quote'}}}
place_order
Accept a supplier quote and create an order (status pending_payment) for one of your inquiries. Pass the inquiry_id and the chosen quote_id (from list_quotes' acceptable_quote_ids). Optionally pass a mandate_id (from create_payment_mandate) to auto-authorize the order against an AP2 payment mandate within its limits — the response then includes mandate_authorization (authorized/declined + reason). Returns the order id, order_no and a payment next_step. Idempotent per inquiry: re-calling returns the existing order. Requires authentication.
Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['inquiry_id', 'quote_id'], 'properties': {'quote_id': {'type': 'string', 'description': "The quote_id to accept (from list_quotes' acceptable_quote_ids)"}, 'inquiry_id': {'type': 'string', 'description': 'The inquiry_id (from request_quote / list_quotes)'}, 'mandate_id': {'type': 'string', 'description': 'Optional AP2 payment mandate id (from create_payment_mandate) to auto-authorize this order within pre-approved limits.'}}}
request_quote
Start a transaction by sending a quote request (inquiry) to a supplier for a specific product_id (get one from search_products). Returns an inquiry_id. Requires authentication — the inquiry is owned by the authenticated buyer. The supplier then submits a quote; poll it with list_quotes.
Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['product_id'], 'properties': {'quantity': {'type': 'number', 'description': 'Desired quantity (optional)'}, 'buyer_note': {'type': 'string', 'description': 'Free-text note to the supplier (optional)'}, 'product_id': {'type': 'string', 'description': 'Product id to request a quote for (from search_products)'}, 'quantity_unit': {'type': 'string', 'description': "Unit for the quantity, e.g. 'pcs', 'kg' (optional)"}, 'destination_city': {'type': 'string', 'description': 'Destination city (optional)'}, 'destination_country': {'type': 'string', 'description': 'Destination country ISO2 (optional)'}}}
search_products
Search live products listed by ProcureRadar suppliers by keyword, destination country, supplier country, or category. Returns product_id values needed to request a quote. Free & anonymous (IP rate-limited). This is the first step of the buyer-side transaction loop: search_products → request_quote → list_quotes → place_order.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Keyword (product title / SKU / supplier name)'}, 'limit': {'type': 'number', 'description': 'Max results (default 20, max 50)'}, 'category': {'type': 'string', 'description': 'Category code (mall_category_code), optional'}, 'country_iso': {'type': 'string', 'description': 'Destination country ISO2 (filters by deliverable SKUs)'}, 'supplier_country': {'type': 'string', 'description': 'Supplier origin country ISO2'}}}
search_stores
Discover verified supplier storefronts (supply nodes) on ProcureRadar by target-market country and industry. Each store groups multiple products from one verified supplier and returns sample_product_ids you can quote on. Use this to find a supplier store first, then search_products / request_quote. Free & anonymous (IP rate-limited). Organizing principle: country × industry matrix.
Solo lectura Acceso externo Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Store name keyword (optional)'}, 'limit': {'type': 'number', 'description': 'Max results (default 20, max 50)'}, 'country': {'type': 'string', 'description': 'Target-market country ISO2 the store operates/sells into (e.g. MY, VN, JP)'}, 'industry': {'type': 'string', 'description': "Industry key (85-industry taxonomy, aligns with product category codes, e.g. 'beauty_personal_care')"}}}
submit_discovery_job
Explicitly submit an async batch buyer discovery job for a category + country. Returns a job_id; poll it with check_discovery_task until status=completed. Note: find_buyers already auto-starts a background crawl when coverage is thin, so usually you only need this for a forced/fresh deep crawl.
Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['category', 'country_iso'], 'properties': {'category': {'type': 'string', 'description': 'Product category to discover buyers for'}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Additional keywords to refine the search'}, 'country_iso': {'type': 'string', 'description': 'Target country ISO code'}}}
Añadido
list_payment_mandates
17 de September de 2026 a las 12:52
Añadido
create_payment_mandate
17 de September de 2026 a las 12:52
Añadido
place_order
17 de September de 2026 a las 12:52
Añadido
list_quotes
17 de September de 2026 a las 12:52
Añadido
request_quote
17 de September de 2026 a las 12:52
Añadido
search_stores
17 de September de 2026 a las 12:52
Añadido
search_products
17 de September de 2026 a las 12:52
Añadido
list_group_buy_pools
17 de September de 2026 a las 12:52
Añadido
check_discovery_task
17 de September de 2026 a las 12:52
Añadido
submit_discovery_job
17 de September de 2026 a las 12:52
Añadido
analyze_buyer_intelligence
17 de September de 2026 a las 12:52
Añadido
enrich_buyer_contact
17 de September de 2026 a las 12:52
Añadido
find_buyers
17 de September de 2026 a las 12:52