eBay MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with eBay MCP or direct API to search marketplace listings, inspect item details, browse categories, and receive marketplace notifications through natural language.

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

Try eBay now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
eBay
Try asking
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.

SETUP GUIDE

Connect eBay MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["ebay"],
  mcp: true,
});
Create a session scoped to eBay and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Search eBay for refurbished noise-cancelling headphones under $150",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a eBay request
SETUP GUIDE

Connect eBay API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["ebay"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to eBay
3

Run eBay tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Search eBay for refurbished noise-cancelling headphones under $150" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the eBay tool calls through the session, and print the final answer

Why Use Composio?

AI Native eBay Integration

  • Supports both eBay MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable marketplace, taxonomy, and notification tool execution
  • Rich coverage for searching listings, inspecting items, and querying eBay data

Managed Auth

  • Connect your own eBay OAuth credentials through a single integration
  • Central place to manage, scope, and revoke eBay access
  • Per user and per environment credentials instead of hard-coded secrets

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access eBay
  • Scoped, least privilege access to eBay marketplace, taxonomy, and notification resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
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