

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

