# How to integrate eBay MCP with Atomic Agent

```json
{
  "title": "How to integrate eBay MCP with Atomic Agent",
  "toolkit": "eBay",
  "toolkit_slug": "ebay",
  "framework": "Atomic Agent",
  "framework_slug": "atomic-agent",
  "url": "https://composio.dev/toolkits/ebay/framework/atomic-agent",
  "markdown_url": "https://composio.dev/toolkits/ebay/framework/atomic-agent.md",
  "updated_at": "2026-11-06T07:05:01.900Z"
}
```

## 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](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions.

## Also integrate eBay with

- [ChatGPT](https://composio.dev/toolkits/ebay/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/ebay/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/ebay/framework/hermes-agent)

## TL;DR

### 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

### Connect eBay to Atomic Agent
- Sign up or sign in to the [Composio dashboard](https://dashboard.composio.dev/?cta_placement=atomic-agent-api-key). Copy your API key.
- 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.
- Ask Atomic Agent to do something in eBay. It searches Composio for the right tool.
- 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.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `EBAY_BUY_BROWSE_CHECK_COMPATIBILITY` | Browse: Check Compatibility | Check whether an eBay Motors part is compatible with a supplied car, truck, or motorcycle definition without changing the item. |
| `EBAY_BUY_BROWSE_GET_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. |
| `EBAY_BUY_BROWSE_GET_ITEMS` | Browse: Get Items | Retrieve details for up to 20 eBay items or 10 item groups in one request. This limited-release operation requires selected-partner access. |
| `EBAY_BUY_BROWSE_GET_ITEMS_BY_ITEM_GROUP` | Browse: Get Items By Item Group | Retrieve every purchasable item variation and shared description in an eBay Browse item group. |
| `EBAY_BUY_BROWSE_SEARCH` | 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. |
| `EBAY_BUY_BROWSE_SEARCH_BY_IMAGE` | 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. To continue, pass the cursor and repeat the same image; search selectors are restored from the cursor. |
| `EBAY_BUY_DEAL_GET_DEAL_ITEMS` | Deal: Get Deal Items | Retrieve one page of eBay deal items by category, commissionable status, delivery country, and marketplace. This Limited Release operation requires eBay Buy Deal approval. |
| `EBAY_BUY_DEAL_GET_EVENT` | Deal: Get Event | Retrieve the details of one eBay deal event by event ID, including its coupons, dates, terms, and images. This limited-release operation requires eBay approval for the buy.deal scope. |
| `EBAY_BUY_DEAL_GET_EVENT_ITEMS` | 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. This Limited Release operation requires eBay partner approval. |
| `EBAY_BUY_DEAL_GET_EVENTS` | Deal: Get Events | Return one page of eBay deal events for a marketplace, including coupons, event terms, images, and an opaque continuation cursor. This limited-release operation requires eBay approval for the buy.deal scope. |
| `EBAY_BUY_FEED_GET_ITEM_FEED` | Feed: Get Item Feed | Download one byte range of an eBay Item feed gzip file for a top-level category. The restricted Buy Feed API grant and eBay partner approval are required. |
| `EBAY_BUY_FEED_GET_ITEM_GROUP_FEED` | 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. The restricted Buy Feed API grant and eBay partner approval are required. |
| `EBAY_BUY_FEED_GET_ITEM_PRIORITY_FEED` | 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. Consume the daily Item and Item Group feeds before this feed. The restricted Buy Feed API grant and eBay partner approval are required. |
| `EBAY_BUY_FEED_GET_ITEM_SNAPSHOT_FEED` | 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. The restricted Buy Feed API grant and eBay partner approval are required. |
| `EBAY_BUY_MARKETING_GET_MERCHANDISED_PRODUCTS` | Marketing: Get Merchandised Products | Return eBay products selected by category and the BEST_SELLING metric, including catalog IDs, prices, images, reviews, and rating details. This limited-release operation requires eBay Buy Marketing approval. |
| `EBAY_COMMERCE_CHARITY_GET_CHARITY_ORG` | Charity: Get Charity Org | Retrieve details for one eBay-supported charitable organization by its charity organization ID in the US or UK marketplace. |
| `EBAY_COMMERCE_CHARITY_GET_CHARITY_ORGS` | 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. |
| `EBAY_COMMERCE_NOTIFICATION_GET_PUBLIC_KEY` | Notification: Get Public Key | Retrieve the eBay public key identified by a push notification signature for validating that notification's payload. Cache returned keys temporarily instead of requesting one for every notification. |
| `EBAY_COMMERCE_NOTIFICATION_GET_TOPIC` | Notification: Get Topic | Retrieve one eBay notification topic by ID, including its subscription scope requirements and supported payload configurations. |
| `EBAY_COMMERCE_NOTIFICATION_GET_TOPICS` | Notification: Get Topics | Return one page of eBay notification topics, including subscription scope requirements, supported payload configurations, and a continuation cursor. |
| `EBAY_COMMERCE_TAXONOMY_FETCH_ITEM_ASPECTS` | 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. The compressed file can exceed 100 MB, and this bulk operation has a substantially lower daily quota than other Taxonomy operations. |
| `EBAY_COMMERCE_TAXONOMY_GET_CATEGORY_SUGGESTIONS` | 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. |
| `EBAY_COMMERCE_TAXONOMY_GET_CATEGORY_TREE` | 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. Both modes include recursively nested descendants. |
| `EBAY_COMMERCE_TAXONOMY_GET_COMPATIBILITY_PROPERTIES` | 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. |
| `EBAY_COMMERCE_TAXONOMY_GET_COMPATIBILITY_PROPERTY_VALUES` | 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. |
| `EBAY_COMMERCE_TAXONOMY_GET_DEFAULT_CATEGORY_TREE_ID` | Taxonomy: Get Default Category Tree ID | Retrieve the identifier and version of the default eBay category tree for a marketplace. Use the returned identifier with other Taxonomy operations. |
| `EBAY_COMMERCE_TAXONOMY_GET_EXPIRED_CATEGORIES` | Taxonomy: Get Expired Categories | Retrieve mappings from expired eBay leaf categories to the active leaf categories that replaced them. Only mapped category consolidations and splits are returned; expired categories without an active replacement are omitted. |
| `EBAY_COMMERCE_TAXONOMY_GET_ITEM_ASPECTS_FOR_CATEGORY` | 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. |
| `EBAY_COMMERCE_TRANSLATION_TRANSLATE` | Translation: Translate | Translate one eBay listing title or description from a supported source language to a supported target language without changing a listing. |
| `EBAY_DEVELOPER_ANALYTICS_GET_RATE_LIMITS` | Analytics: Get Rate Limits | Return application-level eBay API quota usage, remaining calls, and reset windows, optionally filtered by API context and name. |

## Supported Triggers

None listed.

## 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](/pricing/platform) for the current limits that apply to your connection.

## Complete Code

None listed.

## Conclusion

### 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](https://atomicagent.io/?cta_placement=atomic-agent-site) or inspect the [Atomic Agent source code](https://github.com/AtomicBot-ai/atomic-agent?cta_placement=atomic-agent-repo).

## How to build eBay MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/ebay/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/ebay/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/ebay/framework/hermes-agent)

## Related Toolkits

- [Addresszen](https://composio.dev/toolkits/addresszen) - Addresszen is a real-time address autocomplete and verification service. It helps capture accurate, deliverable addresses with instant suggestions and validation.
- [Amazon](https://composio.dev/toolkits/amazon) - Amazon is a global e-commerce marketplace for products, sellers, and digital services. Its broad selection and reliable fulfillment help businesses reach customers worldwide.
- [Asin data api](https://composio.dev/toolkits/asin_data_api) - Asin data api gives you detailed, real-time product data from Amazon, including price, rank, and reviews. Perfect for e-commerce pros and data-driven marketers who need instant marketplace insights.
- [Baselinker](https://composio.dev/toolkits/baselinker) - BaseLinker is an all-in-one e-commerce management platform connecting stores, marketplaces, carriers, and more. It streamlines order processing, inventory control, and automates your sales operations.
- [Bestbuy](https://composio.dev/toolkits/bestbuy) - Best Buy is a leading retailer offering APIs for product, store, and recommendation data. Instantly access up-to-date retail insights for smarter shopping and decision-making.
- [Bluebarry](https://composio.dev/toolkits/bluebarry) - Bluebarry is a customer data and product-advice platform for shopper identities, profiles, and recommendations. It helps teams analyze customer context and synchronize shopper data for better commerce experiences.
- [Cdr platform](https://composio.dev/toolkits/cdr_platform) - Cdr platform is an API for purchasing carbon dioxide removal services. It enables businesses to offset emissions by accessing verified carbon removal projects.
- [ClickFunnels 2.0](https://composio.dev/toolkits/clickfunnels) - ClickFunnels 2.0 is a sales funnel and online business platform for marketing, commerce, courses, and websites. It helps businesses build and manage customer journeys from one workspace.
- [Cloudcart](https://composio.dev/toolkits/cloudcart) - CloudCart is an e-commerce platform for building and managing online stores. It helps businesses streamline product listings, orders, and customer engagement.
- [Clover](https://composio.dev/toolkits/clover) - Clover is a point-of-sale and merchant platform that provides payments, orders, inventory, and device APIs. Use it to manage orders, customers, employees, payments, and receipts across locations.
- [Commerce Layer](https://composio.dev/toolkits/commerce_layer) - Commerce Layer is a headless commerce platform with transactional APIs for orders, inventory, pricing, customers, and fulfillment. Use it to centralize ecommerce operations and surface real-time commerce data.
- [Countdown api](https://composio.dev/toolkits/countdown_api) - Countdown API gives you real-time, structured eBay product data, reviews, and seller feedback. Perfect for powering price monitoring, product research, or marketplace analytics workflows.
- [Creem](https://composio.dev/toolkits/creem) - Creem is a merchant-of-record platform for managing products, checkouts, subscriptions, customers, licenses, discounts, transactions, refunds, and revenue operations. Helps businesses handle billing, compliance, and revenue workflows with a unified billing stack.
- [Dpd2](https://composio.dev/toolkits/dpd2) - Dpd2 is a robust email management platform for handling, sorting, and automating email workflows. Streamline your communications and boost productivity with advanced sorting, labeling, and response tools.
- [Finerworks](https://composio.dev/toolkits/finerworks) - FinerWorks is an online platform for fine art and photo printing services. Artists and photographers use it to order custom prints and manage print inventory efficiently.
- [Fingertip](https://composio.dev/toolkits/fingertip) - Fingertip is a business management platform for selling, booking, and customer engagement—all from a single link. It helps businesses streamline operations and connect with customers across social channels.
- [Fraudlabs pro](https://composio.dev/toolkits/fraudlabs_pro) - FraudLabs Pro is an online payment fraud detection service for e-commerce and merchants. It helps minimize chargebacks and revenue loss by detecting and preventing fraudulent transactions.
- [Gift up](https://composio.dev/toolkits/gift_up) - Gift Up! is a digital platform for selling, managing, and redeeming gift cards online. It streamlines promotions and gift card transactions for businesses and their customers.
- [Goody](https://composio.dev/toolkits/goody) - Goody is a gifting platform that lets users send gifts and physical products without handling logistics. It streamlines gifting by managing delivery, fulfillment, and recipient experience.
- [Google Merchant Center](https://composio.dev/toolkits/google_merchant) - Google Merchant Center is a commerce platform for managing product data, inventory, promotions, and reports. It helps businesses keep product listings accurate and ready for Google Shopping.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and eBay MCP?

With a standalone eBay MCP server, the agents and LLMs can only access a fixed set of eBay tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from eBay and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Atomic Agent?

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right eBay tools.

### Can I manage the permissions and scopes for eBay while using Tool Router?

Yes, absolutely. You can configure which eBay scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your eBay data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)