`ebay_get_item`

Pack: ebay · Endpoint: https://gateway.pipeworx.io/ebay/mcp

Get full detail for a single eBay item. Accepts either the RESTful item ID (“v1|123456789|0”) or the legacy numeric ID (“123456789”).

Parameters

Name	Type	Required	Description
`item_id`	string	yes	RESTful ID (v1\|XXX\|0) or legacy numeric ID

Example call

curl -X POST https://gateway.pipeworx.io/ebay/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ebay_get_item","arguments":{}}}'

Response shape

Always returns: item_id, title

Field	Type	Description
`item_id`	string	eBay item ID
`title`	string	Item title
`short_description`	string \| null	Brief item description
`description`	string \| null	Full item description
`price`	string \| null	Price with currency (e.g. ‘99.99 USD’)
`condition`	string \| null	Item condition (e.g. NEW, USED)
`condition_description`	string \| null	Detailed condition description
`category_path`	string \| null	Category hierarchy path
`brand`	string \| null	Product brand
`mpn`	string \| null	Manufacturer part number
`image_url`	string \| null	Primary product image URL
`additional_images`	array	Additional product image URLs
`seller`	string \| null	Seller username
`seller_feedback_pct`	string \| null	Seller feedback percentage
`seller_feedback_score`	number \| null	Seller feedback score (number of ratings)
`buying_options`	array	Available buying options
`end_date`	string \| null	Auction end date (ISO format)
`available_quantity`	number \| null	Estimated available quantity
`top_rated_buying_experience`	boolean	Whether item qualifies for top-rated buying experience
`shipping`	array	Available shipping options
`returns_accepted`	boolean \| null	Whether returns are accepted
`return_period`	string \| null	Return period (e.g. ‘30 DAYS’)
`url`	string \| null	eBay item webpage URL

Full JSON Schema

{
  "type": "object",
  "properties": {
    "item_id": {
      "type": "string",
      "description": "eBay item ID"
    },
    "title": {
      "type": "string",
      "description": "Item title"
    },
    "short_description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Brief item description"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Full item description"
    },
    "price": {
      "type": [
        "string",
        "null"
      ],
      "description": "Price with currency (e.g. '99.99 USD')"
    },
    "condition": {
      "type": [
        "string",
        "null"
      ],
      "description": "Item condition (e.g. NEW, USED)"
    },
    "condition_description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Detailed condition description"
    },
    "category_path": {
      "type": [
        "string",
        "null"
      ],
      "description": "Category hierarchy path"
    },
    "brand": {
      "type": [
        "string",
        "null"
      ],
      "description": "Product brand"
    },
    "mpn": {
      "type": [
        "string",
        "null"
      ],
      "description": "Manufacturer part number"
    },
    "image_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "Primary product image URL"
    },
    "additional_images": {
      "type": "array",
      "description": "Additional product image URLs",
      "items": {
        "type": "string"
      }
    },
    "seller": {
      "type": [
        "string",
        "null"
      ],
      "description": "Seller username"
    },
    "seller_feedback_pct": {
      "type": [
        "string",
        "null"
      ],
      "description": "Seller feedback percentage"
    },
    "seller_feedback_score": {
      "type": [
        "number",
        "null"
      ],
      "description": "Seller feedback score (number of ratings)"
    },
    "buying_options": {
      "type": "array",
      "description": "Available buying options",
      "items": {
        "type": "string"
      }
    },
    "end_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Auction end date (ISO format)"
    },
    "available_quantity": {
      "type": [
        "number",
        "null"
      ],
      "description": "Estimated available quantity"
    },
    "top_rated_buying_experience": {
      "type": "boolean",
      "description": "Whether item qualifies for top-rated buying experience"
    },
    "shipping": {
      "type": "array",
      "description": "Available shipping options",
      "items": {
        "type": "object",
        "properties": {
          "cost": {
            "type": [
              "string",
              "null"
            ],
            "description": "Shipping cost with currency"
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Shipping type (e.g. STANDARD, EXPEDITED)"
          }
        }
      }
    },
    "returns_accepted": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Whether returns are accepted"
    },
    "return_period": {
      "type": [
        "string",
        "null"
      ],
      "description": "Return period (e.g. '30 DAYS')"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "eBay item webpage URL"
    }
  },
  "required": [
    "item_id",
    "title"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "ebay": {
      "url": "https://gateway.pipeworx.io/ebay/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

ebay_get_item

Parameters

Example call

Response shape

Connect

Was this helpful?

`ebay_get_item`