Skip to main content
Glama
anshux1

Shopping MCP Server

by anshux1

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HOSTNoHTTP listener host for 'http' or 'dual' transport
PORTNoHTTP listener port for 'http' or 'dual' transport
NODE_ENVNoSet to 'production' when deploying
EBAY_MOCKNoSet to 'true' for the deterministic offline catalogfalse
JWT_ISSUERNoOptional JWT claim validation value
JWT_SECRETNoShared Better Auth signing secret; use a long random secret outside development
EBAY_APP_IDNoeBay application ID for live Browse/Taxonomy calls
DATABASE_URLNoPostgres/Neon connection string; takes precedence over file storage
EBAY_CERT_IDNoeBay certificate ID for live Browse/Taxonomy calls
JWT_AUDIENCENoOptional JWT claim validation value
DATABASE_FILENoLocal JSON store path, or ':memory:' for tests
SHOPPING_TAX_RATENoDecimal tax rate used in checkout, for example '0.0725'
MCP_TRANSPORT_TYPENoTransport type: 'stdio', 'http', or 'dual'; otherwise NitroStack selects stdio in development and dual in production
EBAY_MARKETPLACE_IDNoeBay marketplace, default `EBAY_US`EBAY_US

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tasks
{
  "list": {},
  "cancel": {},
  "requests": {
    "tools": {
      "call": {}
    }
  }
}
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "subscribe": true,
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_productsB

Search the eBay catalog for products matching a text query and optional category.

get_productA

Retrieve current details and pricing for one eBay item.

get_categoriesA

Retrieve the eBay category tree, or a category subtree when category_id is supplied.

add_to_cartC

Add a product to the authenticated user cart. Never pass a user ID; it comes from the JWT subject.

view_cartA

View the authenticated user cart and its current item subtotal.

update_cart_itemA

Set an item quantity in the authenticated user cart; quantity 0 removes it.

checkoutA

Create a short-lived checkout quote using live eBay prices and availability. This does not place an order.

place_orderA

Place an authenticated user order from an unexpired checkout quote and clear the cart.

get_orderB

Retrieve one order belonging to the authenticated user.

order_historyA

List orders belonging only to the authenticated user, newest first.

cancel_orderA

Cancel an order belonging to the authenticated user when it has not already been cancelled.

Prompts

Interactive templates invoked by user choice

NameDescription
shopping_assistantA reusable prompt for researching products and preparing a safe cart workflow.

Resources

Contextual data attached and managed by the client

NameDescription
Shopping Catalog GuideHow to search eBay products and safely inspect current item details.
Featured ProductsA small catalog sample for demos and clients that need an initial shopping view.
Shopping CategoriesThe current eBay category tree used by the product search tool.
Cart GuideInstructions for adding, viewing, and updating cart items.
Order GuideThe safe checkout and order-management sequence for the shopping MCP server.
Order StatusesSupported order lifecycle states.
Health ChecksCurrent health status of all registered health checks
Product Search ResultsUI component for Product Search Results
Product CardUI component for Product Card
Category TreeUI component for Category Tree
Cart SummaryUI component for Cart Summary
Order ConfirmationUI component for Order Confirmation
Order SummaryUI component for Order Summary
Order CancellationUI component for Order Cancellation
Widget ExamplesProvides metadata and examples for all registered UI widgets

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/anshux1/amazon-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server