Canopy API

Name: Canopy API
Author: canopy-api

by canopy-apiversion 2.1.0i★ –iRuns in the cloud

Registry nameco.canopyapi/mcp

Install

Overview

Description from the maker (original English)

Amazon product API & MCP server: search, prices, reviews, sellers, deals, and ASIN lookup by Canopy.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs in the cloud
Transport: Streamable HTTP
Category: Search & AI memory
You need to fill in: CANOPY-API-KEY

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on the maker’s server: what you ask it goes through their server.
You fill in yourself: CANOPY-API-KEY

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

Runs in the cloudNothing to install; it connects over the internet

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Run this in your terminal

claude mcp add --transport http canopyapi https://mcp.canopyapi.co/mcp --header 'CANOPY-API-KEY: your-value'

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "canopyapi": {
      "url": "https://mcp.canopyapi.co/mcp",
      "headers": {
        "CANOPY-API-KEY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "canopyapi": {
      "type": "http",
      "url": "https://mcp.canopyapi.co/mcp",
      "headers": {
        "CANOPY-API-KEY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

CANOPY-API-KEY secret HTTP header
Canopy API key (optional — the server also supports OAuth login via canopyapi.co, discovered automatically by OAuth-capable MCP clients).

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

We have not read this server’s tool list yet; we check endpoints in rotation.

Basic checksi

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 6, 2026

✓ Pass
Maker matches the repo
The registry name was verified against the domain canopyapi.co (the registry checks domain ownership)
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
… Not checked yet
Endpoint responds
Not checked yet; we check endpoints in rotation
… Not checked yet
Sign-in with OAuth
Not checked yet; we check endpoints in rotation
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

Compared with others in Search & AI memoryi

More stars than 0% of the other 7226 servers in this category
Published to the registry more recently than 36% of the other 7226 servers in this category
Basic checks equal to or better than 100% of the other 7226 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Canopy API safe?

It passed 1 of 1 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.

What keys or codes does it need?

You need to fill in: CANOPY-API-KEY

Does it run on my computer or in the cloud?

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.

Is it still maintained?

The GitHub repo last changed –, and the latest version (2.1.0) reached the registry 2 months ago.

Which apps can use it?

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 in developer mode.

What can I use instead?

In the same category: Context7, Codebase Memory, Exa

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Context7

by upstash

Feeds AI the latest docs for libraries and frameworks before it answers, so code it writes does not use outdated, removed functions.

Computer or cloud★ 64,224MITUpdated 3 days ago

Install

Codebase Memory

by DeusData

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

Runs on your computer★ 48,148MITUpdated 20 days ago

Install

Exa

by exa-labs

Connect AI agents to Exa for web search, content fetching, and multi-step research.

Runs in the cloud★ 5,213MITUpdated 44 days ago

Install

README from the maker

Open the README

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.

Canopy 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, 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.

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
Review analysis — an Amazon reviews API returning top customer reviews with ratings, helpful votes, and media for summarization

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

17 Amazon Data Tools — product info, variants, offers, stock, sales, reviews, 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

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.

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-key
API-KEY: your-api-key
X-API-KEY: your-api-key
Authorization: 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 17 tools are read-only (readOnlyHint: true) and annotated with a title.

Product Information

get_amazon_product — product details by ASIN, URL, or GTIN
get_amazon_product_variants — product variants
get_amazon_product_offers — seller offers and Buy Box info
get_amazon_product_stock — stock level estimates
get_amazon_product_sales — sales estimates (weekly, monthly, annual)
get_amazon_product_top_reviews — top customer reviews (title, body, rating, helpful votes, images/videos)

Search & Discovery

search_amazon_products — search with filters and sorting
get_amazon_autocomplete — search term suggestions
get_amazon_deals — current deals, optionally filtered by category
get_amazon_bestsellers — best-selling products for a category
get_amazon_bestseller_categories — best seller category list

Entities

get_amazon_seller — seller information and product listings
get_amazon_author — author information and book listings

Identifiers

get_amazon_asin_from_gtin — ASIN lookup by ISBN/UPC/EAN
get_amazon_gtin_from_asin — GTIN lookup by ASIN

Project Structure

canopy-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

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 (emits worker.js for Cloudflare)
npm run deploy — build + wrangler deploy --env production
npm run delete — remove the deployed Worker
npm run generate — regenerate API types from the OpenAPI spec
npm run validate:plugin — check plugin.json, mcp.json, and skills/ against Agent Plugins 1.0.0

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

Model Context Protocol
[xmcp framework](https://

Only the beginning is shown; read the rest in the repo

Canopy API

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Search & AI memoryi

Common questions

Alternatives

Context7

Codebase Memory

Exa

README from the maker

Canopy MCP Server — Amazon Product Data API for AI Agents

Why an Amazon MCP server?

Features

Quick Start

Use the hosted server (no install)

Install the plugin

Run it yourself

Testing

Authentication

Available Tools

Product Information

Search & Discovery

Categories

Entities

Identifiers

Project Structure

Type Safety

Scripts

Migration from v1.x

License

Related