Resollo Agent API
Ce que fait ce MCP
Searches a marketplace, retrieves product and seller information, creates draft listings from photos, handles offers and reservations, and provides order and review tools.
Outils
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['categories', 'conditions', 'currencies', 'default_currency', 'payment_methods', 'shipment_methods', 'sort_options', 'limits', 'policy_urls'], 'properties': {'limits': {'type': 'object', 'required': ['search_max_limit', 'create_product_max_images'], 'properties': {'search_max_limit': {'type': 'number'}, 'create_product_max_images': {'type': 'number'}}, 'additionalProperties': False}, 'categories': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'key', 'name_en'], 'properties': {'id': {'type': 'number'}, 'key': {'type': 'string'}, 'name_en': {'type': 'string'}}, 'additionalProperties': False}}, 'conditions': {'type': 'array', 'items': {'type': 'object', 'required': ['value', 'key', 'name_en'], 'properties': {'key': {'type': 'string'}, 'value': {'type': 'number'}, 'name_en': {'type': 'string'}}, 'additionalProperties': False}}, 'currencies': {'type': 'array', 'items': {'type': 'string'}}, 'policy_urls': {'type': 'object', 'required': ['ai_policy', 'openapi_spec'], 'properties': {'ai_policy': {'type': 'string'}, 'openapi_spec': {'type': 'string'}}, 'additionalProperties': False}, 'sort_options': {'type': 'array', 'items': {'type': 'string'}}, 'payment_methods': {'type': 'array', 'items': {'type': 'string'}}, 'default_currency': {'type': 'string'}, 'shipment_methods': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['role'], 'properties': {'role': {'enum': ['buyer', 'seller'], 'type': 'string', 'description': "Whose side to list from: 'buyer' returns offers you sent, 'seller' returns offers received on your listings."}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of most-recent offers to return (1-50, default 20).'}, 'state': {'enum': ['pending', 'accepted', 'rejected', 'countered', 'buyer_accepted', 'expired'], 'type': 'string', 'description': 'Optional filter to a single offer state. When omitted, offers in every state are returned.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['offers'], 'properties': {'offers': {'type': 'array', 'items': {'type': 'object', 'required': ['offer_id', 'product_id', 'product_name', 'role', 'state', 'offered_price', 'counter_price', 'created_at', 'expires_at'], 'properties': {'role': {'enum': ['buyer', 'seller'], 'type': 'string'}, 'state': {'enum': ['pending', 'accepted', 'rejected', 'countered', 'buyer_accepted', 'expired'], 'type': 'string'}, 'offer_id': {'type': 'string'}, 'created_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'product_id': {'type': 'string'}, 'product_name': {'type': 'string'}, 'counter_price': {'anyOf': [{'type': 'object', 'required': ['amount', 'currency'], 'properties': {'amount': {'type': 'number'}, 'currency': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'offered_price': {'type': 'object', 'required': ['amount', 'currency'], 'properties': {'amount': {'type': 'number'}, 'currency': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['product_id', 'offered_price'], 'properties': {'product_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'The uuid of the fixed-price listing to bid on.'}, 'currency_code': {'type': 'string', 'pattern': '^[A-Z]{3}$', 'description': "ISO 4217 code for offered_price. Defaults to the product's own listing currency if omitted."}, 'offered_price': {'type': 'number', 'description': "The price the buyer offers, in `currency_code` (or the listing's own currency if that is omitted).", 'exclusiveMinimum': 0}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['offer_id', 'product_id', 'state', 'offered_price', 'created_at'], 'properties': {'state': {'type': 'string', 'const': 'pending'}, 'offer_id': {'type': 'string'}, 'created_at': {'type': 'string'}, 'product_id': {'type': 'string'}, 'offered_price': {'type': 'object', 'required': ['amount', 'currency'], 'properties': {'amount': {'type': 'number'}, 'currency': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['offer_id', 'action'], 'properties': {'action': {'enum': ['accept', 'reject', 'counter', 'accept_counter'], 'type': 'string', 'description': 'Seller actions on a pending offer: accept | reject | counter (counter_price required). Buyer action on a countered offer: accept_counter.'}, 'offer_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'The uuid of the offer to respond to.'}, 'counter_price': {'type': 'number', 'description': "The seller's counter-offer price. Required when action is `counter`.", 'exclusiveMinimum': 0}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['offer_id', 'state'], 'properties': {'state': {'enum': ['accepted', 'rejected', 'countered', 'buyer_accepted'], 'type': 'string'}, 'offer_id': {'type': 'string'}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['orderId'], 'properties': {'orderId': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'The uuid of the dispatched, not-yet-paid order.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order_id', 'checkout_url'], 'properties': {'order_id': {'type': 'string'}, 'checkout_url': {'type': 'string'}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['role'], 'properties': {'role': {'enum': ['buyer', 'seller'], 'type': 'string', 'description': "Whose side to list from: 'buyer' returns orders you placed, 'seller' returns orders on your listings."}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of most-recent orders to return (1-50, default 20).'}, 'currency': {'type': 'string', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 code for the returned price fields. Defaults to USD. Same semantics as in search_products.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['orders', 'count'], 'properties': {'count': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'orders': {'type': 'array', 'items': {'type': 'object', 'required': ['order_id', 'role', 'reserved', 'dispatched', 'paid', 'received', 'rejected', 'closed', 'product_name', 'item_count', 'total_price', 'counterparty', 'url', 'created_at', 'completed_at'], 'properties': {'url': {'type': 'string'}, 'paid': {'type': 'boolean'}, 'role': {'enum': ['buyer', 'seller'], 'type': 'string'}, 'closed': {'type': 'boolean'}, 'order_id': {'type': 'string'}, 'received': {'type': 'boolean'}, 'rejected': {'type': 'boolean'}, 'reserved': {'type': 'boolean'}, 'created_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'dispatched': {'type': 'boolean'}, 'item_count': {'type': 'number'}, 'total_price': {'type': 'object', 'required': ['amount', 'currency'], 'properties': {'amount': {'type': 'number'}, 'currency': {'type': 'string'}}, 'additionalProperties': False}, 'completed_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'counterparty': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'product_name': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['product_id', 'payment_method', 'shipment_method', 'confirm'], 'properties': {'comment': {'type': 'string', 'maxLength': 500, 'description': 'Optional note to the seller, attached to the order chat.'}, 'confirm': {'type': 'boolean', 'const': True, 'description': 'Human-confirmation gate. Must be true, and only set it after the user has explicitly approved this specific order having seen the payment-safety text. An agent must never set this on its own initiative.'}, 'currency': {'type': 'string', 'pattern': '^[A-Z]{3}$', 'description': "Informational only, used solely to detect a currency mismatch worth surfacing to the buyer (payment_safety.currency_mismatch). Does NOT change what gets charged -- the order is always recorded and settled in the listing's own native currency regardless of this value."}, 'quantity': {'type': 'integer', 'default': 1, 'maximum': 20, 'minimum': 1, 'description': 'Units to reserve (1-20, default 1).'}, 'product_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'The uuid of the fixed-price listing to reserve.'}, 'address_key': {'type': 'string', 'maxLength': 20, 'minLength': 1, 'description': "Key of one of the buyer's own saved addresses (never a free-text address). Required unless shipment_method is `personal`; defaults to the buyer's active address when omitted."}, 'payment_method': {'enum': ['cash', 'card', 'bank', 'paypal', 'stripe'], 'type': 'string', 'description': 'How buyer and seller will settle payment off-platform. Must be one the seller accepts (see get_product.seller.accepted_payment_methods).'}, 'shipment_method': {'enum': ['personal', 'courier', 'postal', 'locker'], 'type': 'string', 'description': 'How the item will be handed over. Must be one the seller accepts (see get_product.seller.accepted_shipment_methods).'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order_id', 'state', 'product', 'quantity', 'total_price', 'payment_method', 'shipment_method', 'payment_safety', 'created_at'], 'properties': {'state': {'type': 'string', 'const': 'reserved'}, 'product': {'type': 'object', 'required': ['id', 'name', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}}, 'additionalProperties': False}, 'order_id': {'type': 'string'}, 'quantity': {'type': 'number'}, 'created_at': {'type': 'string'}, 'total_price': {'type': 'object', 'required': ['amount', 'currency'], 'properties': {'amount': {'type': 'number'}, 'currency': {'type': 'string'}}, 'additionalProperties': False}, 'payment_method': {'enum': ['cash', 'card', 'bank', 'paypal', 'stripe'], 'type': 'string'}, 'payment_safety': {'type': 'object', 'required': ['generic', 'method', 'currency_mismatch', 'item_not_as_described', 'dispute_fallback'], 'properties': {'method': {'type': 'string'}, 'generic': {'type': 'string'}, 'dispute_fallback': {'type': 'string'}, 'currency_mismatch': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'item_not_as_described': {'type': 'string'}}, 'additionalProperties': False}, 'shipment_method': {'enum': ['personal', 'courier', 'postal', 'locker'], 'type': 'string'}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['orderId'], 'properties': {'orderId': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'The uuid of the RESERVED order to reject.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order_id', 'state'], 'properties': {'state': {'type': 'string', 'const': 'rejected'}, 'order_id': {'type': 'string'}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['orderId'], 'properties': {'orderId': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': "The order's uuid."}, 'currency': {'type': 'string', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 code for the returned price fields. Defaults to USD. Same semantics as in search_products.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order_id', 'reserved', 'dispatched', 'paid', 'received', 'rejected', 'closed', 'carrier', 'tracking_number', 'total_price', 'created_at', 'completed_at'], 'properties': {'paid': {'type': 'boolean'}, 'closed': {'type': 'boolean'}, 'carrier': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'order_id': {'type': 'string'}, 'received': {'type': 'boolean'}, 'rejected': {'type': 'boolean'}, 'reserved': {'type': 'boolean'}, 'created_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'dispatched': {'type': 'boolean'}, 'total_price': {'type': 'object', 'required': ['amount', 'currency'], 'properties': {'amount': {'type': 'number'}, 'currency': {'type': 'string'}}, 'additionalProperties': False}, 'completed_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'tracking_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['images'], 'properties': {'name': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Optional override for the AI-generated title.'}, 'unit': {'type': 'string', 'default': 'piece', 'maxLength': 20, 'description': 'Unit of sale (default "piece").'}, 'price': {'type': 'number', 'description': "Optional fixed price override. When omitted, Resollo's AI price-suggestion sets it.", 'exclusiveMinimum': 0}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['mime_type', 'data'], 'properties': {'data': {'type': 'string', 'minLength': 1, 'description': 'Base64-encoded image bytes (never a URL).'}, 'mime_type': {'enum': ['image/jpeg', 'image/png', 'image/webp'], 'type': 'string', 'description': 'Declared image type. Only a hint -- the decoded bytes are re-validated server-side.'}}}, 'maxItems': 5, 'minItems': 1, 'description': "1-5 real photo files of the item. Resollo's own AI generates the listing content from these."}, 'quantity': {'type': 'integer', 'default': 1, 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Units available (default 1).'}, 'condition': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Optional override for the AI-chosen condition code (see getMarketplaceInfo.conditions).', 'exclusiveMinimum': 0}, 'guarantee': {'type': 'string', 'maxLength': 500, 'description': 'Optional warranty / guarantee text.'}, 'category_id': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Optional override for the AI-chosen category id (see getMarketplaceInfo.categories).', 'exclusiveMinimum': 0}, 'description': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'Optional override for the AI-generated description.'}, 'offers_enabled': {'type': 'boolean', 'default': True, 'description': 'Whether buyers may send Make-an-Offer bids on the listing.'}, 'is_business_listing': {'type': 'boolean', 'default': False, 'description': 'Whether this is a business (vs. private) listing.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['product_id', 'state', 'suggested', 'activation_url', 'quota_remaining'], 'properties': {'state': {'type': 'string', 'const': 'inactive'}, 'suggested': {'type': 'object', 'required': ['name', 'description', 'category', 'condition', 'attributes', 'semantic_profile', 'shipment_prices', 'price'], 'properties': {'name': {'type': 'string'}, 'price': {'type': 'object', 'required': ['amount', 'currency', 'min', 'max', 'reasoning'], 'properties': {'max': {'type': 'number'}, 'min': {'type': 'number'}, 'amount': {'type': 'number'}, 'currency': {'type': 'string'}, 'reasoning': {'type': 'string'}}, 'additionalProperties': False}, 'category': {'type': 'object', 'required': ['id', 'key', 'name_en'], 'properties': {'id': {'type': 'number'}, 'key': {'type': 'string'}, 'name_en': {'type': 'string'}}, 'additionalProperties': False}, 'condition': {'type': 'object', 'required': ['value', 'key', 'name_en'], 'properties': {'key': {'type': 'string'}, 'value': {'type': 'number'}, 'name_en': {'type': 'string'}}, 'additionalProperties': False}, 'attributes': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'description': {'type': 'string'}, 'shipment_prices': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'object', 'required': ['local', 'international'], 'properties': {'local': {'type': 'string'}, 'international': {'type': 'string'}}, 'additionalProperties': False}}, 'semantic_profile': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}}, 'additionalProperties': False}, 'product_id': {'type': 'string'}, 'activation_url': {'type': 'string'}, 'quota_remaining': {'type': 'object', 'required': ['autofill', 'price_suggestion'], 'properties': {'autofill': {'type': 'number'}, 'price_suggestion': {'type': 'number'}}, 'additionalProperties': False}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['productId'], 'properties': {'currency': {'type': 'string', 'pattern': '^[A-Z]{3}$', 'description': 'ISO 4217 code for the returned price fields. Defaults to USD. Same semantics as in search_products.'}, 'productId': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': "The product listing's uuid."}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'name', 'description', 'category', 'condition', 'price', 'converted_price', 'listing_type', 'auction_ends_at', 'quantity_available', 'image_url', 'seller', 'url', 'created_at', 'unit', 'guarantee', 'min_price', 'offers_enabled', 'attributes', 'semantic_profile', 'image_urls', 'shipment_prices'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'unit': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'price': {'type': 'object', 'required': ['amount', 'currency'], 'properties': {'amount': {'type': 'number'}, 'currency': {'type': 'string'}}, 'additionalProperties': False}, 'seller': {'type': 'object', 'required': ['id', 'alias', 'is_verified', 'country_code', 'region_code', 'avatar_url', 'city', 'stripe_connect_active', 'accepted_payment_methods', 'accepted_shipment_methods'], 'properties': {'id': {'type': 'string'}, 'city': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'alias': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'avatar_url': {'type': 'string'}, 'is_verified': {'type': 'boolean'}, 'region_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'country_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'stripe_connect_active': {'type': 'boolean'}, 'accepted_payment_methods': {'type': 'array', 'items': {'type': 'string'}}, 'accepted_shipment_methods': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}, 'category': {'type': 'object', 'required': ['id', 'key', 'name_en'], 'properties': {'id': {'type': 'number'}, 'key': {'type': 'string'}, 'name_en': {'type': 'string'}}, 'additionalProperties': False}, 'condition': {'type': 'object', 'required': ['value', 'key', 'name_en'], 'properties': {'key': {'type': 'string'}, 'value': {'type': 'number'}, 'name_en': {'type': 'string'}}, 'additionalProperties': False}, 'guarantee': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'min_price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'attributes': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'created_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'image_urls': {'type': 'array', 'items': {'type': 'string'}}, 'description': {'type': 'string'}, 'listing_type': {'enum': ['fixed_price', 'auction'], 'type': 'string'}, 'offers_enabled': {'type': 'boolean'}, 'auction_ends_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'converted_price': {'anyOf': [{'type': 'object', 'required': ['amount', 'currency'], 'properties': {'amount': {'type': 'number'}, 'currency': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'shipment_prices': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'semantic_profile': {'anyOf': [{'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, {'type': 'null'}]}, 'quantity_available': {'type': 'number'}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'q': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': "Free-text search across the listing's canonical name and description."}, 'sort': {'enum': ['newest', 'price_asc', 'price_desc'], 'type': 'string', 'default': 'newest', 'description': 'Result ordering. Never influenced by paid placement.'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results to return per page (1-50, default 20).'}, 'cursor': {'type': 'string', 'maxLength': 2000, 'description': "Opaque pagination cursor from a previous response's next_cursor."}, 'category': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Numeric top-level category id (see getMarketplaceInfo.categories). Subcategory ids are accepted but rolled up to their top-level parent in the response.', 'exclusiveMinimum': 0}, 'currency': {'type': 'string', 'pattern': '^[A-Z]{3}$', 'description': "ISO 4217 code used for price filtering and each result's converted_price. Defaults to USD. Must be one of getMarketplaceInfo.currencies."}, 'location': {'type': 'string', 'maxLength': 200, 'description': 'Comma-separated seller-location filters. Each entry is a 2-letter ISO country code ("HU") or a "COUNTRY:REGION" pair ("HU:BU"). Reflects the seller\'s profile location, not a per-listing field.'}, 'price_max': {'type': 'number', 'minimum': 0, 'description': 'Maximum price in the resolved `currency`.'}, 'price_min': {'type': 'number', 'minimum': 0, 'description': "Minimum price in the resolved `currency` (converted price, not the seller's native currency)."}, 'seller_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': "Restrict results to one seller's listings. The uuid is the seller.id from any search or getProduct result."}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['products', 'next_cursor', 'count'], 'properties': {'count': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'products': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'description', 'category', 'condition', 'price', 'converted_price', 'listing_type', 'auction_ends_at', 'quantity_available', 'image_url', 'seller', 'url', 'created_at'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'name': {'type': 'string'}, 'price': {'type': 'object', 'required': ['amount', 'currency'], 'properties': {'amount': {'type': 'number'}, 'currency': {'type': 'string'}}, 'additionalProperties': False}, 'seller': {'type': 'object', 'required': ['id', 'alias', 'is_verified', 'country_code', 'region_code'], 'properties': {'id': {'type': 'string'}, 'alias': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'is_verified': {'type': 'boolean'}, 'region_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'country_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'category': {'type': 'object', 'required': ['id', 'key', 'name_en'], 'properties': {'id': {'type': 'number'}, 'key': {'type': 'string'}, 'name_en': {'type': 'string'}}, 'additionalProperties': False}, 'condition': {'type': 'object', 'required': ['value', 'key', 'name_en'], 'properties': {'key': {'type': 'string'}, 'value': {'type': 'number'}, 'name_en': {'type': 'string'}}, 'additionalProperties': False}, 'image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'created_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'description': {'type': 'string'}, 'listing_type': {'enum': ['fixed_price', 'auction'], 'type': 'string'}, 'auction_ends_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'converted_price': {'anyOf': [{'type': 'object', 'required': ['amount', 'currency'], 'properties': {'amount': {'type': 'number'}, 'currency': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'quantity_available': {'type': 'number'}}, 'additionalProperties': False}}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['product_id', 'question'], 'properties': {'question': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'The public question text (1-500 characters).'}, 'product_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'The uuid of the product to ask about.'}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'product_id', 'message', 'answer', 'created_at', 'answered_at'], 'properties': {'id': {'type': 'number'}, 'answer': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'message': {'type': 'string'}, 'created_at': {'type': 'string'}, 'product_id': {'type': 'string'}, 'answered_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'questioner_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['productId'], 'properties': {'productId': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': "The product listing's uuid."}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['questions'], 'properties': {'questions': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'product_id', 'message', 'answer', 'created_at', 'answered_at'], 'properties': {'id': {'type': 'number'}, 'answer': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'message': {'type': 'string'}, 'created_at': {'type': 'string'}, 'product_id': {'type': 'string'}, 'answered_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'questioner_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['productId'], 'properties': {'productId': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': "The product listing's uuid."}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['reviews', 'avg_rating', 'review_count'], 'properties': {'reviews': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'rating', 'message', 'reviewer_name', 'created_at'], 'properties': {'id': {'type': 'number'}, 'rating': {'type': 'number'}, 'message': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'created_at': {'type': 'string'}, 'reviewer_name': {'type': 'string'}}, 'additionalProperties': False}}, 'avg_rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'review_count': {'type': 'number'}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['sellerId'], 'properties': {'sellerId': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': "The seller's uuid -- the seller.id from any search or getProduct result."}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'name', 'avatar_url', 'about', 'is_verified', 'country_code', 'region_code', 'city', 'member_since', 'accepted_payment_methods', 'accepted_shipment_methods', 'stripe_connect_active', 'active_listing_count', 'sold_count', 'follower_count', 'rating', 'feedback_count', 'profile_url', 'shop_url'], 'properties': {'id': {'type': 'string'}, 'city': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'name': {'type': 'string'}, 'about': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'shop_url': {'type': 'string'}, 'avatar_url': {'type': 'string'}, 'sold_count': {'type': 'number'}, 'is_verified': {'type': 'boolean'}, 'profile_url': {'type': 'string'}, 'region_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'country_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'member_since': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'feedback_count': {'type': 'number'}, 'follower_count': {'type': 'number'}, 'active_listing_count': {'type': 'number'}, 'stripe_connect_active': {'type': 'boolean'}, 'accepted_payment_methods': {'type': 'array', 'items': {'type': 'string'}}, 'accepted_shipment_methods': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of most-recent listings to return (1-100, default 50).'}, 'state': {'enum': ['active', 'inactive', 'pending_moderation', 'rejected', 'closed'], 'type': 'string', 'description': "Optional filter to a single listing state. 'inactive' is where products.create drafts sit until the seller activates them. When omitted, listings in every state are returned."}}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['listings', 'count'], 'properties': {'count': {'type': 'number'}, 'listings': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'state', 'state_flags', 'listing_type', 'price', 'quantity', 'offers_enabled', 'edit_url', 'created_at', 'updated_at'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'price': {'type': 'object', 'required': ['amount', 'currency'], 'properties': {'amount': {'type': 'number'}, 'currency': {'type': 'string'}}, 'additionalProperties': False}, 'state': {'enum': ['active', 'inactive', 'pending_moderation', 'rejected', 'closed', 'unknown'], 'type': 'string'}, 'edit_url': {'type': 'string'}, 'quantity': {'type': 'number'}, 'created_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'updated_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'state_flags': {'type': 'object', 'required': ['subscription_paused', 'missing_methods'], 'properties': {'missing_methods': {'type': 'boolean'}, 'subscription_paused': {'type': 'boolean'}}, 'additionalProperties': False}, 'listing_type': {'enum': ['fixed_price', 'auction'], 'type': 'string'}, 'offers_enabled': {'type': 'boolean'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
Schéma d’entrée
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Schéma de sortie
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['can_create_products', 'max_products', 'can_create_auctions', 'has_payment_method', 'has_shipment_method', 'max_images', 'max_price', 'ai_credits_remaining'], 'properties': {'max_price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'max_images': {'type': 'number'}, 'max_products': {'type': 'number'}, 'has_payment_method': {'type': 'boolean'}, 'can_create_auctions': {'type': 'boolean'}, 'can_create_products': {'type': 'boolean'}, 'has_shipment_method': {'type': 'boolean'}, 'ai_credits_remaining': {'type': 'number'}}, 'additionalProperties': False}
Modifications récentes des outils
Serveurs MCP similaires
AgentLot Marketplace
Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.
zobrx
Provides read-only ecommerce operations and analytics for orders, inventory, marketplace performance, advertising, settlements, t…
SupplySlate
Supports component sourcing, fabrication requests, supplier RFQs, catalog imports, quotes, purchase planning, checkout handoffs, …
Obriym CRM
Manages CRM records, sales pipelines, activities, orders, products, inventory, and marketplace catalog operations.
velora
Provides Argentine commerce operations including catalog and inventory, customer and supplier management, cash register tracking,…
Shopify
Provides read access to Shopify Admin data for store operations through the Shopify REST API.
Woocommerce
Provides access to WooCommerce store data through the WooCommerce REST API.
Troostwijk
Searches European industrial and insolvency liquidation auctions and retrieves auction lot details.