What this MCP does
Enables agents to search, compare, research, and request quotes for products in a cross-vendor B2B catalog.
Capabilities
Tools
8
tools
compare_products
Compare products
Compare 2-10 catalog products side-by-side on their datasheet specs. Slugs come from search_catalog and are case-insensitive and dash-tolerant ("e-STUDIO 331AC", "toshiba-e-studio-331ac" and "e-studio331ac" all resolve to the same product).
Returns one item per product with canonical_name and spec_absence_note (spec fields absent from that product's golden record, AirShelf's verified product record). Branch on each item's commercial_data.actionable before using price or stock; stale observations are withheld from action fields. A slug that does not resolve comes back as not_found with a did_you_mean suggestion. The `provenance` option adds the source page and source type already stored with each fact.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slugs'], 'properties': {'slugs': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 10, 'minItems': 2, 'description': 'Catalog slugs to compare'}, 'provenance': {'type': 'boolean', 'description': 'Include the stored source page and source type for each fact'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['items'], 'properties': {'count': {'type': 'number'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string'}, 'price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'modelName': {'type': 'string'}, 'manufacturer': {'type': 'string'}, 'canonical_name': {'type': 'string'}, 'spec_absence_note': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}}, 'additionalProperties': False}
explain_product
Explain how a record was built
Explain the evidence behind a catalog row. Returns stored processing stages when available and always returns a golden-record field summary with source coverage. A field's evidence_sha256 is the SHA-256 of the source document AirShelf archived when it extracted that claim. A caller holding the same bytes can compare the hash to check that the cited document has not changed. AirShelf does not serve those archived bytes, and the hash does not promise they remain retrievable. record.scraped_at is the catalog row's scrape time, not a per-claim evidence capture time.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'minLength': 1, 'description': 'Composite slug to explain'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'sku': {'type': 'string'}, 'note': {'type': 'string'}, 'slug': {'type': 'string'}, 'count': {'type': 'number'}, 'trace': {}, 'record': {}, 'category': {'type': 'string'}, 'trace_status': {'enum': ['available', 'not_recorded'], 'type': 'string'}, 'canonical_name': {'type': 'string'}}, 'additionalProperties': False}
find_products
Discover and verify products for a need
Discover candidate products for a buyer need. Takes a need in natural language (e.g. "best value home espresso machine", market "TH"), checks the verified catalog first, then uses live web discovery only when the catalog has no candidates. Returns up to 3 candidates with explicit fit accounting.
find_products is the quick candidate-list tool; research_shopping is the full verified-research job. For a specific brand+model, search_catalog is cheaper and returns the same live-lookup block on a miss.
Response fields:
⢠candidates[].verification â "catalog-candidate" for a catalog starting point whose fit still needs checking, or "live-unverified" for a live page read during this run.
⢠candidates[].status â "resolved" means both identity and the parsed buyer constraints were supported by the cited page; "abstain" means identity or need fit could not be established. Inspect constraint_check for matched, conflicting, and unverified requirements.
⢠candidates[].constraint_check.receipts maps each receipt-backed matched requirement to its supporting source URL and trust label.
⢠Candidates come from current web-search results, so they are a sample of what the market offers rather than a ranking.
⢠status at the top level â "no_match" means discovery ran but no candidate was confirmed as satisfying the need; "disabled", "rate_limited", or "unavailable" means no discovery ran.
⢠live_discovery.status="unavailable" means receipted catalog candidates were returned while live discovery was unavailable.
Optional `market` (ISO 3166-1 alpha-2) biases discovery and marketplace checks toward seller pages serving that country and scopes the lookup cache. "Available in <market>" means the seller page serves that market, not that stock is guaranteed.
Read only
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['need'], 'properties': {'max': {'type': 'integer', 'default': 3, 'maximum': 3, 'minimum': 1, 'description': 'Max candidates to verify (each costs a live lookup; capped at 3).'}, 'need': {'type': 'string', 'maxLength': 200, 'minLength': 3, 'description': 'The buyer need in natural language, e.g. "quiet mechanical keyboard for open office" or "best value home espresso machine".'}, 'market': {'type': 'string', 'description': 'Buyer market as ISO 3166-1 alpha-2 country code (e.g. "TH"). Biases discovery and marketplace checks toward seller pages serving that country and scopes the cache; availability is not a stock guarantee.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['candidates'], 'properties': {'need': {'type': 'string'}, 'error': {'type': 'string'}, 'market': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'reason': {'type': 'string'}, 'status': {'enum': ['ok', 'no_match', 'disabled', 'rate_limited', 'unavailable', 'error', 'refused'], 'type': 'string'}, 'took_ms': {'type': 'number'}, 'guidance': {'type': 'string'}, 'candidates': {'type': 'array', 'items': {'type': 'object', 'required': ['query', 'tier', 'status'], 'properties': {'tier': {'type': 'number'}, 'query': {'type': 'string'}, 'cached': {'type': 'boolean'}, 'reason': {'type': 'string'}, 'status': {'enum': ['resolved', 'abstain', 'declined'], 'type': 'string'}, 'product': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'guidance': {'type': 'string'}, 'identity': {'type': 'object', 'required': ['brand', 'model'], 'properties': {'brand': {'type': 'string'}, 'model': {'type': 'string'}}, 'additionalProperties': False}, 'source_url': {'type': 'string'}, 'source_tier': {'type': 'string'}, 'verification': {'type': 'string'}, 'mpn_confirmed': {'type': 'boolean'}}, 'additionalProperties': {}}}, 'verification': {'type': 'string'}, 'live_discovery': {'type': 'object', 'required': ['status'], 'properties': {'reason': {'type': 'string'}, 'status': {'type': 'string', 'const': 'unavailable'}, 'guidance': {'type': 'string'}}, 'additionalProperties': False}, 'serp_considered': {'type': 'number'}}, 'additionalProperties': False}
get_product
Get product details
Get the full golden record (AirShelf's verified product record) and latest price for one catalog product by slug ("<manufacturer>-<model>").
Returns the product's specs and provenance (which page each fact came from), plus canonical_name (its exact catalog name). A field's evidence_sha256 is the SHA-256 of the source document AirShelf archived when it extracted that claim. A caller holding the same bytes can compare the hash to check that the cited document has not changed. AirShelf does not serve those archived bytes, and the hash does not promise they remain retrievable. Branch on commercial_data.actionable before using price or stock: observations older than 24 hours are withheld from latestPrice and retained only as labelled last_observed history. For quote-gated B2B pricing, a null price with a quote path is expected rather than an error. In clients that render MCP Apps the response also draws one product card per call. related_products â relationships extracted from vendor documents (e.g. compatible toner or drum accessories with their source quotes, functional equivalents, supersessions); each entry names the related catalog slug, the relation type, its direction (direction is "from_this" when the relation reads this-product â related-product, "to_this" when it reads related-product â this-product), and the source URL and quote the relation was extracted from.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'minLength': 1, 'description': 'Composite slug, e.g. keychron-q1-pro'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['title', 'productId', 'buttonLabel', 'action'], 'properties': {'title': {'type': 'string'}, 'action': {'enum': ['quote', 'link'], 'type': 'string'}, 'buyUrl': {'type': 'string'}, 'product': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'benefits': {'type': 'array', 'items': {'type': 'string'}}, 'imageUrl': {'type': 'string'}, 'productId': {'type': 'string'}, 'buttonLabel': {'type': 'string'}, 'pricing_gated': {'type': 'boolean'}, 'related_products': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}, 'additionalProperties': False}
list_merchants
List merchants
List public AirShelf merchants that have an assigned slug and at least one active product. Internal/demo and empty catalogs are excluded. Returns each merchant's name, slug, and product count; the slug is the `merchant` argument for request_quote.
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['merchants'], 'properties': {'total': {'type': 'number'}, 'merchants': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'slug', 'product_count'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'domain': {'type': 'string'}, 'product_count': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': {}}}}, 'additionalProperties': False}
request_quote
Request a quote from a merchant
Send a quote request for catalog products to a merchant's sales team on behalf of a named buyer.
This is a two-step, double opt-in flow. The first call emails a confirmation link to `contact.email` and returns status "confirmation_required"; no lead exists and no merchant is contacted until the buyer confirms. A later call with the same arguments reports "awaiting_confirmation" while the email is unconfirmed, or "received" with a reference_number after confirmation.
Merchant slugs come from list_merchants. Network-catalog brands that are absent from that list use merchant:"airshelf-network" with brandSlug:"<manufacturer-slug>"; AirShelf routes the confirmed request to that brand.
Destructive
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['merchant', 'products', 'contact'], 'properties': {'notes': {'type': 'string', 'description': 'Any extra context from the buyer'}, 'contact': {'type': 'object', 'required': ['name', 'email'], 'properties': {'name': {'type': 'string', 'description': 'Buyer name'}, 'email': {'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 work email'}, 'company': {'type': 'string', 'description': 'Buyer company'}}, 'description': 'Buyer contact details'}, 'merchant': {'type': 'string', 'minLength': 1, 'description': 'Merchant slug or id (from list_merchants), or "airshelf-network" for network-catalog brands'}, 'products': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 50, 'minItems': 1, 'description': 'Catalog slugs the buyer is interested in'}, 'quantity': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Units the buyer wants', 'exclusiveMinimum': 0}, 'brandSlug': {'type': 'string', 'minLength': 1, 'description': 'Manufacturer slug (from search results) â\x80\x94 required with merchant:"airshelf-network" so the lead reaches the right brand'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'status': {'type': 'string'}, 'next_step': {'type': 'string'}, 'reference_number': {'type': 'string'}}, 'additionalProperties': False}
research_shopping
Research a considered purchase
research_shopping is the full verified-research job; find_products is the quick candidate-list tool. It runs as a background job and returns status "running" with a research ID while the minutes-long research continues; the same research ID returns the run on later polls until completion. Unsafe medical, legal, financial-advice, and professional-service asks return status "refused" before any work is queued. Completed runs return a researched recommendation with per-claim source receipts, or an explicit refusal when evidence is insufficient. Missing decision details return clarification questions before research starts. `market` biases discovery and marketplace checks toward seller pages serving that country; "available in <market>" means the seller page serves that market, not that stock is guaranteed. Example answer keys include {"budget":"500 USD","market":"US","category":"espresso machine"}.
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'need': {'type': 'string', 'maxLength': 2000, 'minLength': 1, 'description': 'Buyer need in natural language. Required when starting a new research run.'}, 'market': {'type': 'string', 'description': 'Buyer market as an ISO 3166-1 alpha-2 country code. Biases discovery and marketplace checks toward seller pages serving that country; availability is not a stock guarantee.'}, 'answers': {'type': 'object', 'description': 'Answers to clarification questions. Set accept_defaults:true to accept budget and market defaults; it does not waive product type, use case, or must-have requirements.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'persona': {'enum': ['consumer', 'b2b'], 'type': 'string', 'description': 'Research persona; b2b produces a quotation/RFQ pack.'}, 'research_id': {'type': 'string', 'description': 'Existing research run identifier to read instead of starting a new run.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status'], 'properties': {'stage': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'reason': {'type': 'string'}, 'status': {'enum': ['needs_input', 'running', 'complete', 'failed', 'refused'], 'type': 'string'}, 'dossier': {}, 'outcome': {'anyOf': [{'enum': ['recommend', 'conditional', 'insufficient_evidence', 'no_candidate_passes', 'defer'], 'type': 'string'}, {'type': 'null'}]}, 'questions': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'question'], 'properties': {'key': {'enum': ['budget', 'market', 'category'], 'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': False}}, 'eta_seconds': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'research_id': {'type': 'string'}, 'stage_counters': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'elapsed_seconds': {'type': 'number'}, 'accepted_defaults': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}}, 'additionalProperties': False}
search_catalog
Search product catalog
Search the AirShelf cross-vendor product catalog by natural-language query. The catalog covers industrial-automation components (sensors, encoders, vacuum handling, motors and drives, circuit protection, machine vision â the largest category by row count), wiring devices (plugs, receptacles, connector bodies, rocker switches), multifunction printers (mfp), barcode printers, laser printers, mechanical keyboards, cybersecurity products, and threat-intelligence platforms. Industrial-automation and wiring-device rows are indexed by manufacturer part number, so a brand or part number in the query ("Pepperl+Fuchs retroreflective sensor", "IN5409") retrieves more reliably than a bare product type; those rows carry no normalized spec facets, so the `specs` filter does not apply to them. Returns ranked products with prices, specs, and per-row match accounting.
Each row includes `unverified_specs`, the normalized spec names that lack claim-level receipts; never use those as decisive facts.
Example queries: "tactile mechanical keyboard under $150", "Toshiba A3 colour multifunction device", "industrial barcode printer for a warehouse", "threat-intelligence platform with dark-web monitoring".
Result fields:
⢠canonical_name â the exact catalog name of the product.
⢠spec_absence_note â spec fields absent from this product's golden record (AirShelf's verified product record); null when nothing is missing.
⢠constraint_match_score and matched_criteria â query constraints supported by claim-level receipts. unverified_criteria names matching catalog values that still need confirmation; missing_criteria names values that are absent or conflict.
⢠parsed.price_availability â all_null = true means every returned price is null. For quote-gated B2B pricing, a null price with a quote path is expected rather than an error; query_had_budget reports whether the query carried one.
⢠result.commercial_data â branch on actionable before using price or stock. Observations older than 24 hours are withheld from result.price/result.inStock and retained only as labelled last_observed history.
⢠parsed.weak_match â the response contains an unresolved constraint, query match, or product-identity warning. parsed.unverified_identity_count counts returned names without an identity receipt. parsed.no_match â no product satisfies a hard constraint, and candidates violating it were excluded server-side.
On a miss or near-miss for a specific brand+model the response may also carry a `tier3` block, meaning a real-time lookup for the exact SKU asked about; it can appear alongside fuzzy-neighbour rows.
⢠tier3.status = "resolved" â a single-source reading of the page at tier3.source_url. MPN-confirmed means the live lookup matched the manufacturer part number. Its verification is "live-unverified": confirmed on a live page during this run, but not yet matched to an AirShelf catalog record. A verified row is matched to the catalog record. tier3.cached = true means it came from a recent prior lookup, with fetched_at recording when the page was read.
⢠tier3.status = "abstain" â the lookup could not confirm the product exists as asked, so no specs, price, or availability were established. tier3.guidance describes the quote-request path.
⢠tier3.status = "declined" â an applicable lookup did not run; tier3.reason says why (disabled, rate_limited, daily_cap, negative_cache, error). No specs or availability were established, and none should be inferred.
No tier3 block at all means a live lookup was not applicable to this query (no parseable brand+model identity).
Optional `market` (ISO 3166-1 alpha-2, e.g. "TH") excludes catalog rows whose country-specific URL conflicts with the buyer market and scopes tier3 lookup/cache. A remaining global URL is not local-availability proof: parsed.weak_match stays true and unsatisfied_constraints includes market_availability until every returned row has a matching country receipt. "Available in <market>" still does not guarantee stock.
Read only
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['q'], 'properties': {'q': {'type': 'string', 'maxLength': 200, 'minLength': 0, 'description': 'Natural-language query, at most 200 characters. Supports budget hints (e.g. "under $150").'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 200, 'minimum': 1, 'description': 'Max results'}, 'specs': {'type': 'object', 'description': 'Hard spec facets, e.g. {"form_factor":"desktop","print_speed_ppm":33}. Filters by exact/range spec match.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'anyOf': [{'type': 'number'}, {'type': 'string'}, {'type': 'boolean'}]}}, 'market': {'type': 'string', 'description': 'Buyer market as an assigned ISO 3166-1 alpha-2 country code (e.g. "TH", "AU"). Conflicting country receipts are excluded; global URLs remain market-unverified.'}, 'category': {'type': 'string', 'description': 'Optional category filter (industrial-automation, wiring-devices, mechanical-keyboards, mfp, barcode-printer, laser-printer, inkjet-printer, cybersecurity, or threat-intelligence-platform)'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['results'], 'properties': {'count': {'type': 'number'}, 'query': {'type': 'string'}, 'tier3': {'type': 'object', 'required': ['tier', 'status'], 'properties': {'tier': {'type': 'number'}, 'cached': {'type': 'boolean'}, 'reason': {'type': 'string'}, 'status': {'enum': ['resolved', 'abstain', 'declined'], 'type': 'string'}, 'product': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'guidance': {'type': 'string'}, 'identity': {'type': 'object', 'required': ['brand', 'model'], 'properties': {'brand': {'type': 'string'}, 'model': {'type': 'string'}}, 'additionalProperties': False}, 'source_url': {'type': 'string'}, 'source_tier': {'type': 'string'}, 'verification': {'type': 'string'}, 'mpn_confirmed': {'type': 'boolean'}}, 'additionalProperties': {}}, 'parsed': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'reason': {'type': 'string'}, 'status': {'enum': ['refused'], 'type': 'string'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string'}, 'price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'category': {'type': 'string'}, 'currency': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'modelName': {'type': 'string'}, 'manufacturer': {'type': 'string'}, 'qualityScore': {'type': 'number'}, 'canonical_name': {'type': 'string'}, 'spec_absence_note': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'constraint_match_score': {'type': 'number'}}, 'additionalProperties': {}}}, 'took_ms': {'type': 'number'}}, 'additionalProperties': False}
History
Recent tool changes
Added
request_quote
2026年9月11日0:30
Added
list_merchants
2026年9月11日0:30
Added
explain_product
2026年9月11日0:30
Added
compare_products
2026年9月11日0:30
Added
get_product
2026年9月11日0:30
Added
research_shopping
2026年9月11日0:30
Added
find_products
2026年9月11日0:30
Added
search_catalog
2026年9月11日0:30
Discover
Similar MCP servers
Agentic Fabrication Network (AFN)
ai.agenticfabricationnetwork/ufp
Obtains quotes and places orders for 3D printing, CNC and sheet-metal fabrication, decals, and related manufacturing services.
AgentRoam
ai.agentroam/agentroam
Browses and purchases travel eSIMs, gift cards, and mobile top-ups using supported cryptocurrencies, with order validation and st…
beauty
ai.adoraads/beauty
Finds and recommends sponsored beauty products, brands, and skincare routines based on shopper preferences and skin profiles.
1325.AI
ai.1325/mcp
Provides a searchable directory of Black-owned U.S. businesses with map and loyalty-reward features.
mcp
ai.agentxray/mcp
Helps Amazon sellers calculate per-unit profit from settlement data and prepare drafts for seller approval.
AgentUtility Retail
ai.agentutility/mcp-retail
Pay-per-call x402 MCP cluster identified as retail-related; no tools are exposed in the registry.
Graffeo Coffee Roasting
ai.agenticshelf/graffeo
Provides a live product catalog for Graffeo Coffee Roasting.
Agentic Shelf
ai.agenticshelf/mcp
Provides an e-commerce catalog with live product listings, inventory, and pricing.