How to integrate eBay MCP with Atomic Agent

Connect Atomic Agent to eBay MCP. Find refurbished laptops under $500, compare sold prices for vintage cameras, and more using natural language, with authentication handled for you.

eBay logoeBay
S2s Oauth2

eBay is an online marketplace for buying and selling products worldwide. Its public APIs help developers access listings, categories, and marketplace data.

30 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including eBay.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a eBay account. See the Atomic Agent documentation for installation instructions.

Also integrate eBay with

How Atomic Agent connects to eBay

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect eBay to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in eBay. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your eBay account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the eBay MCP server, and what's possible with it?

The eBay MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your eBay account. It provides structured and secure access to eBay marketplace, category, deal, notification, translation, and developer analytics data, so your agent can search listings, compare item details, discover deals, classify products, and translate listing content on your behalf.

  • Marketplace listing research: Have your agent search eBay by keywords, categories, product details, or images, then retrieve complete information for selected listings and product variations.
  • Deals and product discovery: Let the agent find current deal events, browse discounted items, and surface best-selling products by category, marketplace, and delivery country.
  • Category and listing enrichment: Direct your agent to suggest the right eBay category, identify required item details, review valid category values, and check vehicle compatibility properties for parts listings.
  • Localization and charitable shopping: Instruct your agent to translate listing titles or descriptions and find eBay-supported charitable organizations by name or registration details.
  • Notifications and API monitoring: Have your agent review available notification topics, retrieve public keys for validating eBay notifications, and check application usage limits and reset windows.

Use eBay from Atomic Agent

With your account connected, ask Atomic Agent to work with eBay in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every eBay action and event your agent gets out of the box.

Browse: Check Compatibility

Check whether an eBay Motors part is compatible with a supplied car, truck, or motorcycle definition without changing the item.

Browse: Get Item

Retrieve complete details for one eBay listing or variation by either its RESTful item ID or legacy listing ItemID using an application access token.

Browse: Get Items

Retrieve details for up to 20 eBay items or 10 item groups in one request.

Browse: Get Items By Item Group

Retrieve every purchasable item variation and shared description in an eBay Browse item group.

Browse: Search

Search eBay item summaries by keyword, category, product identifier, charity, compatibility, aspects, and Browse field filters, returning one page plus an opaque continuation cursor.

Browse: Search By Image

Search eBay item summaries using a bare Base64-encoded image, optionally refine the matches, and return one page plus an opaque continuation cursor.

Deal: Get Deal Items

Retrieve one page of eBay deal items by category, commissionable status, delivery country, and marketplace.

Deal: Get Event

Retrieve the details of one eBay deal event by event ID, including its coupons, dates, terms, and images.

Deal: Get Event Items

Return one page of eBay Deal event items for an event, with optional category and delivery-country filters plus an opaque continuation cursor.

Deal: Get Events

Return one page of eBay deal events for a marketplace, including coupons, event terms, images, and an opaque continuation cursor.

Feed: Get Item Feed

Download one byte range of an eBay Item feed gzip file for a top-level category.

Feed: Get Item Group Feed

Download an eBay Item Group feed gzip file, or a byte range, for a top-level category, with downloads limited to 100 MiB.

Feed: Get Item Priority Feed

Download one byte range of an eBay Item Priority delta feed gzip file for a top-level category and date.

Feed: Get Item Snapshot Feed

Download one byte range of an hourly eBay Item Snapshot feed gzip file for a top-level category and UTC hour.

Marketing: Get Merchandised Products

Return eBay products selected by category and the BEST_SELLING metric, including catalog IDs, prices, images, reviews, and rating details.

Charity: Get Charity Org

Retrieve details for one eBay-supported charitable organization by its charity organization ID in the US or UK marketplace.

Charity: Get Charity Orgs

Search supported eBay charitable organizations by keywords or registration IDs, returning one page of complete organization details and an opaque continuation cursor.

Notification: Get Public Key

Retrieve the eBay public key identified by a push notification signature for validating that notification's payload.

Notification: Get Topic

Retrieve one eBay notification topic by ID, including its subscription scope requirements and supported payload configurations.

Notification: Get Topics

Return one page of eBay notification topics, including subscription scope requirements, supported payload configurations, and a continuation cursor.

Taxonomy: Fetch Item Aspects

Download the gzipped JSON item-aspect dataset for leaf categories in an eBay category tree, subject to a 250 MB download limit.

Taxonomy: Get Category Suggestions

Find ranked eBay leaf-category suggestions for free-form item keywords, including each category's ancestor path to the category-tree root.

Taxonomy: Get Category Tree

Retrieve eBay's complete category tree when root_category_id is omitted, or retrieve the subtree rooted at root_category_id when it is provided.

Taxonomy: Get Compatibility Properties

Retrieve the localized vehicle properties that define compatibility for an eBay parts category, such as Make, Model, Year, Engine, and Trim.

Taxonomy: Get Compatibility Property Values

Retrieve the applicable values of one vehicle compatibility property for an eBay parts category, optionally narrowed by other property-value pairs.

Taxonomy: Get Default Category Tree ID

Retrieve the identifier and version of the default eBay category tree for a marketplace.

Taxonomy: Get Expired Categories

Retrieve mappings from expired eBay leaf categories to the active leaf categories that replaced them.

Taxonomy: Get Item Aspects for Category

Retrieve complete eBay aspect metadata for a leaf category, including valid values, value dependencies, listing requirements, variation support, and format constraints.

Translation: Translate

Translate one eBay listing title or description from a supported source language to a supported target language without changing a listing.

Analytics: Get Rate Limits

Return application-level eBay API quota usage, remaining calls, and reset windows, optionally filtered by API context and name.

FAQ

Frequently asked questions

Start with eBay.It takes 30 seconds.

Managed auth, hosted MCP servers, and every eBay tool your agent needs.Free to start.

Start building