ECO SHADES MCP Server

The ECO SHADES MCP server is the official Model Context Protocol server for the ECO SHADES online store. AI assistants can use it to search ECO SHADES sunglasses, look up products and live availability, build carts and start checkout. Every purchase is approved by the buyer.

Connect

Remote (Streamable HTTP): https://www.eco-shades.com/api/ucp/mcp — no API key needed.

Local (stdio, via npm):

{
  "mcpServers": {
    "eco-shades": { "command": "npx", "args": ["-y", "eco-shades-mcp"] }
  }
}

Official MCP Registry name: com.eco-shades/store. npm package: eco-shades-mcp.

Tools

Tool What it does
search_catalog Search products by text and filters.
lookup_catalog Resolve several product or variant IDs in one call.
get_product Full product detail with variants, exact price and live availability.
create_cart, get_cart, update_cart, cancel_cart Build and manage a cart.
create_checkout, get_checkout, update_checkout, cancel_checkout Prepare a checkout with shipping and totals.
complete_checkout Complete a checkout. Only with the buyer's explicit approval.
get_order Order details after purchase.
ask_business Questions about the store, its products and policies.

Always read the live schemas with tools/list. Tool calls need meta["ucp-agent"].profile: the URL of your agent's UCP profile. Store policies and FAQs are also available from a second MCP server at https://www.eco-shades.com/api/mcp (tool: search_shop_policies_and_faqs).

Example

curl -X POST "https://www.eco-shades.com/api/ucp/mcp" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Rules for agents

  • Place orders and submit payment only with the buyer's approval, and follow the review and handoff steps the tools return.
  • Identify agent traffic as described in agents.md.
  • On HTTP 429, back off and respect Retry-After.

More: ECO SHADES API docs · OpenAPI specification · Contact us