AirShelf Catalog
Qué hace este MCP
Enables agents to search, compare, research, and request quotes for products in a cross-vendor B2B catalog.
Herramientas
Esquema de entrada
{'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'}}}
Esquema de salida
{'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}
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'minLength': 1, 'description': 'Composite slug to explain'}}}
Esquema de salida
{'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}
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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}
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'minLength': 1, 'description': 'Composite slug, e.g. toshiba-b-ex4t1-ts12-qm-r'}}}
Esquema de salida
{'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', 'properties': {'sources': {'anyOf': [{'anyOf': [{'type': 'array', 'items': {'anyOf': [{'type': 'object', 'properties': {'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Source document or product-page URL when recorded.'}, 'type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Stored source type, such as pdf or product_page.'}}, 'additionalProperties': {}}, {'type': 'string'}]}}, {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}]}, {'type': 'null'}], 'description': 'Stored evidence sources. Imports may preserve a source object, use ref instead of url, or list plain strings. Null when unavailable.'}, 'updatedAt': {'type': 'string', 'description': 'Catalog row update time as an ISO 8601 timestamp, not a per-claim verification time.'}, 'field_count': {'type': 'number', 'description': 'Total golden-record fields used as the evidence coverage denominator.'}, 'latestPrice': {'anyOf': [{'type': 'object', 'required': ['price', 'currency', 'retailer', 'inStock', 'capturedAt'], 'properties': {'price': {'type': 'number'}, 'inStock': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'currency': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'retailer': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'capturedAt': {'type': 'string'}}, 'additionalProperties': {}}, {'type': 'null'}], 'description': 'Latest valid price observation within 24 hours. Null when absent or stale; stale history remains in commercial_data.last_observed.'}, 'pdfFilenames': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Stored source PDF filenames. A filename is not a download URL.'}, 'qualityScore': {'type': 'number', 'description': 'Percentage of golden-record fields with claim-level citations. Zero when there are no fields.'}, 'lifecycle_status': {'enum': ['current', 'retired'], 'type': 'string', 'description': 'Retirement marker from stored product evidence. current means no retirement marker was found.'}, 'related_products': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'relation', 'direction'], 'properties': {'slug': {'type': 'string'}, 'source': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}], 'description': 'Stored source URL, quote, section or page for the relationship; null when none was recorded.'}, 'relation': {'type': 'string', 'description': 'Relationship type recorded from vendor documents.'}, 'direction': {'enum': ['from_this', 'to_this'], 'type': 'string', 'description': 'from_this means this product points to the related product; to_this means the reverse.'}}, 'additionalProperties': {}}, 'description': 'Documented related catalog products, including accessories, equivalents and replacements.'}, 'cited_field_count': {'type': 'number', 'description': 'Number of golden-record fields with claim-level citations.'}}, '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', 'required': ['slug', 'relation', 'direction'], 'properties': {'slug': {'type': 'string'}, 'source': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}], 'description': 'Stored source URL, quote, section or page for the relationship; null when none was recorded.'}, 'relation': {'type': 'string', 'description': 'Relationship type recorded from vendor documents.'}, 'direction': {'enum': ['from_this', 'to_this'], 'type': 'string', 'description': 'from_this means this product points to the related product; to_this means the reverse.'}}, 'additionalProperties': {}}, 'description': 'Documented related catalog products, including accessories, equivalents and replacements.'}}, 'additionalProperties': False}
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Esquema de salida
{'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'}, 'search_url': {'type': 'string', 'description': 'Merchant-scoped product-search endpoint URL.'}, 'manifest_url': {'type': 'string', 'description': 'Merchant agent manifest URL with supported endpoints and capabilities.'}, 'products_url': {'type': 'string', 'description': 'Merchant product-listing endpoint URL.'}, 'product_count': {'type': 'number', 'exclusiveMinimum': 0}, 'checkout_capability': {'enum': ['shopify', 'redirect'], 'type': 'string', 'description': 'shopify indicates a connected Shopify store; redirect sends the buyer to the product page.'}}, 'additionalProperties': {}}}}, 'additionalProperties': False}
Esquema de entrada
{'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'}}}
Esquema de salida
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'status': {'type': 'string'}, 'next_step': {'type': 'string'}, 'reference_number': {'type': 'string'}}, 'additionalProperties': False}
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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', 'properties': {'stage': {'type': 'string', 'description': 'Current pipeline stage identifier, or queued before work starts.'}, 'verified': {'type': 'number', 'description': 'Candidates examined during verification, not a count of candidates that passed.'}, 'candidates_found': {'type': 'number', 'description': 'Candidates found during discovery.'}, 'listings_checked': {'type': 'number', 'description': 'Market listing URLs recorded during commercial checks.'}}, 'description': 'Progress counters for a running research job. Individual counters may be absent.', 'additionalProperties': {}}, 'elapsed_seconds': {'type': 'number'}, 'accepted_defaults': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}}, 'additionalProperties': False}
Esquema de entrada
{'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, digital-signage, business-display, mfp, barcode-printer, laser-printer, inkjet-printer, mechanical-keyboards, cybersecurity, threat-intelligence-platform)'}, 'merchant': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9-]{0,62}$', 'description': 'Optional merchant slug (e.g. "toshiba", "cyble") from list_merchants. Scopes the search to that merchant\'s own shelf, which is a SEPARATE substrate from the cross-vendor catalog: it is reached only when the cross-vendor catalog returns nothing, and its rows carry the merchant\'s own product data rather than datasheet-extracted golden records. Omit it for cross-vendor search, which is the default and the right choice for "what should I buy".'}}}
Esquema de salida
{'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}
Cambios recientes en herramientas
Servidores MCP similares
AgentLot Marketplace
Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.
apex-x1
Provides X1 and Arc token screening, liquidity and exit-risk checks, wallet and bridge data, non-custodial token operations, comm…
SpellBook Finance
Provides Magic: The Gathering and other trading-card market prices, buylist offers, arbitrage analysis, sealed-product EV, seller…
Vendooly
Manages Amazon Seller Central and Amazon Ads data, including product ads, campaigns, keywords, targeting, budgets, and catalog co…
API Direct
Searches and retrieves data from social networks, news and Google services, while also providing Amazon product, seller, ranking,…
Digital Manager Guru
Provides Digital Manager Guru checkout, customer, transaction, subscription, affiliate, coupon, blocklist, and digital-product sa…
Pagar.me
Connects to Pagar.me to manage customers, cards, orders, charges, invoices, payment captures, confirmations, retries, refunds, an…
amazon-product-research-mcp
Researches Amazon products, brands, sellers, buy-box activity, sourcing profitability, category competition, and supplier opportu…