Spree Commerce developer docs for AI agents
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Amazon product API & MCP server: search, prices, ratings, sellers, deals, and ASIN lookup by Canopy.
Pick the AI app you use, then copy the settings.
Passed 5/5 checks · What you ask goes through the maker’s server (mcp.canopyapi.co)
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude · about 5 min
You need a Canopy API key (create it on the maker’s site) · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
CustomizeConnectors
Copy each value into the field with the same name in Claude, then click Continue
Canopy APIhttps://mcp.canopyapi.co/mcpUnder Request headers, add this name and value
CANOPY-API-KEY<paste your key here>Paste the key only into the app’s field, never into a chat or to anyone
Leave Authentication as Claude detected it, then click Add
+ConnectorsCanopy API
Use Canopy API and tell me what you can do for me, then show me one thing✓ If Claude says it is using Canopy API or shows a Canopy API tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Canopy API yet
Canopy API needs your own key to connect, but OpenAI’s help page only describes OAuth sign-in; there is no key option we could verify
A · Use an app that can connect Canopy API
B · Others in Online shops & payments that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code · about 5 min
You need a Canopy API key (create it on the maker’s site)
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --transport http --scope user canopyapi https://mcp.canopyapi.co/mcp --header 'CANOPY-API-KEY: your-value'Replace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see Canopy API listed as connected
Use Canopy API and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Canopy API or shows a Canopy API tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor · about 5 min
You need a Canopy API key (create it on the maker’s site)
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
In the Canopy API settings, CANOPY-API-KEY is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Canopy API and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Canopy API or shows a Canopy API tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code · about 5 min
You need a Canopy API key (create it on the maker’s site)
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
In the Canopy API settings, CANOPY-API-KEY is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Canopy API and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Canopy API or shows a Canopy API tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
Address for apps that connect over the web
https://mcp.canopyapi.co/mcpJSON settings are under “For developers” below
Claude Code
claude mcp add --transport http --scope user canopyapi https://mcp.canopyapi.co/mcp --header 'CANOPY-API-KEY: your-value'Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"canopyapi": {
"url": "https://mcp.canopyapi.co/mcp",
"headers": {
"CANOPY-API-KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"canopyapi": {
"type": "http",
"url": "https://mcp.canopyapi.co/mcp",
"headers": {
"CANOPY-API-KEY": "your-value"
}
}
}
}These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Connect over the internet in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
The server asks you to sign in before it lists its tools.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 12, 2026
The registry name was verified against the domain canopyapi.co (the registry checks domain ownership)
Code last changed yesterday
Uses MIT
Responded in 140 ms (HTTP 401)
Declares OAuth sign-in, so your AI app can take you to log in
Not checked yet; we read the tool list when we check the endpoint
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: CANOPY-API-KEY
It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.
The GitHub repo last changed yesterday, and the latest version (3.0.0) reached the registry yesterday.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT Business and above.
In the same category: Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability
Servers in the same category from other makers, sorted by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
An Amazon product data API served over the Model Context Protocol. Connect Claude, ChatGPT, Cursor, or any MCP client to real-time Amazon data — an Amazon search API, reviews API, price tracker, ASIN lookup, best sellers, deals, and sales estimates — powered by the Canopy API. No headless browsers, no brittle HTML scraping: typed JSON over standard MCP tools.
Built with xmcp and deployed on Cloudflare Workers. Use the hosted remote MCP server at https://mcp.canopyapi.co/mcp or self-host from this repo. Setup guides and client walkthroughs live on the Amazon MCP server page.
AI agents and LLM apps increasingly need live e-commerce data. This server gives any MCP-capable assistant or agent framework direct tool access to Amazon:
Works as a Claude MCP server (Desktop, Code, and the claude.ai connectors directory), a ChatGPT MCP connector (Apps SDK, with rich product widgets), in Cursor and the MCP Inspector, and with any agent built on the MCP SDK, LangChain, or the OpenAI Agents SDK.
/mcp (current MCP spec)src/tools/openapi-typescriptAdd the remote MCP server to your client and sign in with OAuth, or supply a Canopy API key:
https://mcp.canopyapi.co/mcp
Claude and other OAuth-capable MCP clients will walk you through sign-in automatically. Get an API key at canopyapi.co, and see the Amazon MCP server guide for per-client setup instructions.
The plugin root is this repository. It points every client at the hosted server https://mcp.canopyapi.co/mcp and does not embed an API key. OAuth-capable clients discover sign-in from the server. If a client only supports a static header, set CANOPY-API-KEY in that client.
Two skills ship with the plugin: amazon-product-research and amazon-price-and-deals.
Cursor Marketplace. Install Canopy from Customize or the Cursor Marketplace after it is listed. The listing manifest is .cursor-plugin/plugin.json (name canopy, logo assets/canopy-icon.png). It points mcpServers at .mcp.json, a remote http server, so Cursor starts OAuth against https://mcp.canopyapi.co/mcp without a pasted key. Root mcp.json stays the Agent Plugins file and is not the Cursor listing config. To try it before it is listed, copy this repository to ~/.cursor/plugins/local/canopy (a symlink that points outside that folder is ignored), reload the window, and confirm the Canopy server and both skills in Customize.
Claude Code, from this repo. This repository is also a marketplace. In Claude Code:
claude plugin marketplace add canopy-api/canopy-api-mcp
claude plugin install canopy@canopy-api
Or, inside a session: /plugin marketplace add canopy-api/canopy-api-mcp, then /plugin install canopy@canopy-api. For one session without installing, run claude --plugin-dir /path/to/canopy-api-mcp. The manifest is .claude-plugin/plugin.json, the marketplace catalog is .claude-plugin/marketplace.json, and the server is .mcp.json (type: http). On first use, approve the Canopy OAuth prompt.
Claude.ai and Cowork. After the plugin is listed in Anthropic's directory, add Canopy from the directory. Sign in on the plugin's Connectors tab. The plugin uses the same URL as the existing Canopy connector.
Grok Build. After the plugin is in the xAI plugin marketplace, install it from /marketplace or:
grok plugin install canopy --trust
The first connection opens Canopy's OAuth flow. Skills load from skills/ and the server from .mcp.json.
Other Agent Plugins clients. This repository is also an Agent Plugin (specification 1.0.0). Those clients read root plugin.json (name canopy-api-mcp) and mcp.json (type: streamable-http). They need Agent Plugins 1.0.0. There is no archive and no registry protocol in the specification: the package is this directory.
server.json is the MCP Registry server card (co.canopyapi/mcp), separate from the plugin manifests. npm install, npm run dev, and npm run deploy are unchanged.
Validate the manifests (npm test runs the first command too; it checks that every manifest carries the same version):
npm run validate:plugin
claude plugin validate . --strict grok plugin validate .
Publishing steps for each marketplace are in submissions/README.md.
You'll need a Canopy API key from canopyapi.co.
npm install
npm run dev # xmcp watcher + wrangler dev (local Workers runtime) npm run deploy # build + wrangler deploy --env production
Run npm test to build the worker and run the regression suite. Output-schema tests use mocked REST responses to verify that null-valued fields (unavailable prices, coupons, ratings) are stripped before reaching MCP clients, that responses match the advertised JSON Schema, and that malformed values are still rejected. These tests do not require a real Canopy API key.
Use the MCP Inspector and connect to http://localhost:8787/mcp (or your deployed URL). Provide the API key as a request header:
npx -y @modelcontextprotocol/inspector@latest
Or with curl:
curl -X POST http://localhost:8787/mcp \
-H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -H "CANOPY-API-KEY: $CANOPY_API_KEY" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
Every request must carry credentials. Two modes are supported:
1. OAuth 2.1 (recommended for MCP clients). OAuth-capable clients discover the flow automatically: an unauthenticated request returns 401 with WWW-Authenticate: Bearer resource_metadata="https://mcp.canopyapi.co/.well-known/oauth-protected-resource". Supabase is the authorization server (dynamic client registration supported); consent lives at canopyapi.co. The verified user's Canopy API key is resolved server-side.
2. API key headers. Any of these forms works (checked in this order):
CANOPY-API-KEY: your-api-keyAPI-KEY: your-api-keyX-API-KEY: your-api-keyAuthorization: Bearer your-api-keyA missing or invalid credential returns HTTP 401 with a JSON-RPC error before the request reaches the MCP transport (see src/middleware.ts).
All 17 tools are read-only (readOnlyHint: true) and annotated with a title.
get_amazon_product — product details by ASIN, URL, or GTINget_amazon_product_variants — product variantsget_amazon_product_offers — seller offers and Buy Box infoget_amazon_product_stock — stock level estimatesget_amazon_product_sales — sales estimates (weekly, monthly, annual)get_amazon_product_top_reviews — top customer reviews (title, body, rating, helpful votes, images/videos)search_amazon_products — search with filters and sortingget_amazon_autocomplete — search term suggestionsget_amazon_deals — current deals, optionally filtered by categoryget_amazon_bestsellers — best-selling products for a categoryget_amazon_bestseller_categories — best seller category listget_amazon_categories — root category taxonomyget_amazon_category — category details with products and subcategoriesget_amazon_seller — seller information and product listingsget_amazon_author — author information and book listingsget_amazon_asin_from_gtin — ASIN lookup by ISBN/UPC/EANget_amazon_gtin_from_asin — GTIN lookup by ASINcanopy-api-mcp/
├── .cursor-plugin/plugin.json # Cursor Marketplace manifest ├── .claude-plugin/ │ ├── plugin.json # Claude Code plugin manifest │ └── marketplace.json # self-hosted Claude Code marketplace ├── .grok-plugin/plugin.json # Grok Build plugin manifest ├── .mcp.json # Claude Code, Cursor, and Grok MCP server (HTTP) ├── plugin.json # Agent Plugins 1.0.0 manifest ├── mcp.json # Agent Plugins MCP declaration (Streamable HTTP) ├── skills/ │ ├── amazon-product-research/ │ │ ├── SKILL.md │ │ └── references/tools.md │ └── amazon-price-and-deals/ │ └── SKILL.md ├── submissions/ │ ├── README.md # how to publish to each marketplace │ └── xai-marketplace-entry.json # entry to paste into xai-org/plugin-marketplace ├── server.json # MCP Registry server card (separate from plugin.json) ├── LICENSE # MIT License ├── src/ │ ├── tools/ # one file per tool (auto-discovered by xmcp) │ │ ├── get-amazon-product.ts │ │ └── ... │ ├── lib/ │ │ └── api-key.ts # reads API key from extra.authInfo │ ├── middleware.ts # auth middleware (lifts header → authInfo.token) │ ├── api-client.ts # type-safe Canopy REST client │ └── types/ │ └── api.d.ts # generated from OpenAPI ├── xmcp.config.ts # xmcp config (endpoint, CORS, paths) ├── wrangler.jsonc # Cloudflare Workers config ├── worker-entry.ts # Workers entry (unchanged) ├── tsconfig.json └── package.json
src/types/api.d.ts is generated from the Canopy OpenAPI spec. Regenerate when the API changes:
npm run generate
npm run dev — xmcp watcher + wrangler dev (local Workers runtime)npm run build — xmcp build --cf (emits worker.js for Cloudflare)npm run deploy — build + wrangler deploy --env productionnpm run delete — remove the deployed Workernpm run generate — regenerate API types from the OpenAPI specnpm run validate:plugin — check plugin.json, mcp.json, and skills/ against Agent Plugins 1.0.0v2.0 replaces ModelFetch with xmcp. The MCP endpoint moved from /sse/mcp (deprecated SSE transport mount) to /mcp (current Streamable HTTP convention). Update any clients accordingly.
This project is released under the MIT License. Copyright (c) 2026 Canopy API.