Canopy API MCP server
Commit Nov 10, 2026Connect AI agents to real-time Amazon data including product details, pricing, sales estimates, and search capabilities via the Model Context Protocol.
Also known as canopy-api/canopy-api-mcp, canopy-api-mcp
- Stars
- 4
- Tools
- 16
- Downloads, 30 days
- —
- Latest version
- 3.0.0
- Last commit
- Nov 10, 2026
- License
- MIT
What is Canopy API MCP?
Canopy API connects AI agents to real-time Amazon data including product details, pricing, sales estimates, and search capabilities via the Model Context Protocol. It exposes 16 tools, such as get_amazon_product, get_amazon_product_variants, get_amazon_product_offers.
Summary generated from the project's README
About Canopy API MCP server
Canopy API provides a specialized Model Context Protocol server that connects AI agents to live Amazon e-commerce data. Instead of relying on web scraping, this server delivers structured JSON data through sixteen distinct tools. It is designed for developers building shopping assistants, market analysis tools, or catalog enrichment applications using clients like Claude, ChatGPT, Cursor, or LangChain.
Users can access the service via a hosted remote endpoint at mcp.canopyapi.co/mcp or by self-hosting the server on Cloudflare Workers. Authentication is handled through OAuth 2.1 or by providing an API key in various header formats. The server includes specific tools for searching products, tracking prices, estimating sales volumes, and converting identifiers like ASIN to GTIN or UPC.
What you can do with it
- 1Conducting market researchAn AI agent can analyze product performance by retrieving best seller rankings and sales estimates.
- 2Monitoring competitive pricingDevelopers can build tools that track Buy Box offers and stock levels for specific products.
- 3Automating catalog managementAn agent can convert between different product identifiers such as ASIN and ISBN.
- 4Building shopping assistantsAn AI can help users find products and identify current discounts or coupons.
Written from the project's README. Every use case is checked against a quote from it.
How to install Canopy API MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Canopy API MCP in Claude Code
$ claude mcp add --transport http canopy-api-mcp https://mcp.canopyapi.co/mcpInstall Canopy API MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"canopy-api-mcp": {
"url": "https://mcp.canopyapi.co/mcp"
}
}
}Install Canopy API MCP in VS Code
.vscode/mcp.json
{
"servers": {
"canopy-api-mcp": {
"type": "http",
"url": "https://mcp.canopyapi.co/mcp"
}
}
}Install Canopy API MCP in VS Code CLI
$ code --add-mcp '{"name":"canopy-api-mcp","type":"http","url":"https://mcp.canopyapi.co/mcp"}'Install Canopy API MCP in Codex
$ codex mcp add canopy-api-mcp --url https://mcp.canopyapi.co/mcpInstall Canopy API MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.canopy-api-mcp] url = "https://mcp.canopyapi.co/mcp"
Install Canopy API MCP in Gemini CLI
$ gemini mcp add -s user --transport http canopy-api-mcp https://mcp.canopyapi.co/mcpInstall Canopy API MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"canopy-api-mcp": {
"url": "https://mcp.canopyapi.co/mcp",
"type": "http"
}
}
}Canopy API MCP tools 16
Detected from the READMEget_amazon_productget_amazon_product_variantsget_amazon_product_offersget_amazon_product_stockget_amazon_product_salessearch_amazon_productsget_amazon_autocompleteget_amazon_dealsget_amazon_bestsellersget_amazon_bestseller_categoriesget_amazon_categoriesget_amazon_category
Show all 16 toolsShow fewer tools
get_amazon_sellerget_amazon_authorget_amazon_asin_from_gtinget_amazon_gtin_from_asin
Automated checks
Ran Nov 13, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablecanopy-api/canopy-api-mcp is public and reachablegithub.com/canopy-api/canopy-api-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-10github.com/canopy-api/canopy-api-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model16 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubCanopy MCP Server — Amazon Product Data API for AI Agents
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, 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.
Why an Amazon MCP server?
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:
- Shopping assistants — an Amazon search API for agents: query products, compare prices and Buy Box offers, surface deals and coupons in chat
- Price monitoring & competitive intelligence — an Amazon price tracker API for prices, stock estimates, and seller offers on any ASIN
- Product research & market analysis — an Amazon product research tool with best seller rankings, sales estimates, and category taxonomies
- Catalog enrichment — ASIN lookup and ASIN ↔ GTIN/UPC/ISBN/EAN conversion, plus images, variants, and specs
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.
Features
- 16 Amazon Data Tools — product info, variants, offers, stock, sales, search, autocomplete, categories, best sellers, sellers, authors, deals, and ASIN/GTIN lookup
- Streamable HTTP transport at
/mcp(current MCP spec) - File-based tools — one file per tool under
src/tools/ - Type Safety — TypeScript types generated from the Canopy OpenAPI spec via
openapi-typescript - Flexible Auth — OAuth 2.1 sign-in (Supabase authorization server, dynamic client registration) or an API key in any of four header formats
- CORS Enabled — preflight + custom API key headers allowed
Quick Start
Use the hosted server (no install)
Add 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.
Install the plugin
For Claude Code, Claude.ai, Cursor, and Grok Build, the Canopy plugin bundles this server with two skills, amazon-product-research and amazon-price-and-deals. It lives in its own repository: canopy-api/canopy-plugin. In Claude Code:
claude plugin marketplace add canopy-api/canopy-plugin
claude plugin install canopy@canopy-api
See the plugin README for the other clients. This repository is the server only.
Run it yourself
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
Testing
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":{}}'
Authentication
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-key
A missing or invalid credential returns HTTP 401 with a JSON-RPC error before the request reaches the MCP transport (see src/middleware.ts).
Available Tools
All 16 tools are read-only (readOnlyHint: true) and annotated with a title.
Product Information
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)
Search & Discovery
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 list
Categories
get_amazon_categories— root category taxonomyget_amazon_category— category details with products and subcategories
Entities
get_amazon_seller— seller information and product listingsget_amazon_author— author information and book listings
Identifiers
get_amazon_asin_from_gtin— ASIN lookup by ISBN/UPC/EANget_amazon_gtin_from_asin— GTIN lookup by ASIN
Project Structure
canopy-api-mcp/
├── server.json # MCP Registry server card (co.canopyapi/mcp)
├── 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
Type Safety
src/types/api.d.ts is generated from the Canopy OpenAPI spec. Regenerate when the API changes:
npm run generate
Scripts
npm run dev— xmcp watcher +wrangler dev(local Workers runtime)npm run build—xmcp build --cf(emitsworker.jsfor Cloudflare)npm run deploy— build +wrangler deploy --env productionnpm run delete— remove the deployed Workernpm run generate— regenerate API types from the OpenAPI spec
Migration from v1.x
v2.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.
License
This project is released under the MIT License. Copyright (c) 2026 Canopy API.
Related
- Canopy plugin — this server packaged with skills for Claude, Cursor, and Grok
- Model Context Protocol
- xmcp framework
- Amazon MCP Server — Canopy
- Canopy API
- Cloudflare Workers
Canopy API MCP questions
How do I add Canopy API MCP to Claude Code?
Run claude mcp add --transport http canopy-api-mcp https://mcp.canopyapi.co/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Canopy API MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Canopy API MCP provide?
It exposes 16 tools, including get_amazon_product, get_amazon_product_variants, get_amazon_product_offers, get_amazon_product_stock, get_amazon_product_sales.
What kind of Amazon data can I access?
You can access product info, variants, offers, stock levels, sales estimates, search results, autocomplete, deals, and best sellers.
How do I authenticate with the Canopy MCP server?
You can use OAuth 2.1 (recommended) or provide an API key in one of four header formats: CANOPY-API-KEY, API-KEY, X-API-KEY, or Authorization Bearer.
Can I host the server myself?
Yes, you can self-host the server from the repository using npm and Cloudflare Workers.