# Canopy API MCP server

> Connect AI agents to real-time Amazon data including product details, pricing, sales estimates, and search capabilities via the Model Context Protocol.

- Repository: https://github.com/canopy-api/canopy-api-mcp
- Page: https://hostedmcp.org/servers/canopy-api/canopy-api-mcp
- Transport: remote
- Stars: 4
- License: MIT
- Latest version: 3.0.0

## Install

### Claude Code

```sh
claude mcp add --transport http canopy-api-mcp https://mcp.canopyapi.co/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "canopy-api-mcp": {
      "url": "https://mcp.canopyapi.co/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "canopy-api-mcp": {
      "type": "http",
      "url": "https://mcp.canopyapi.co/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"canopy-api-mcp","type":"http","url":"https://mcp.canopyapi.co/mcp"}'
```

### Codex

```sh
codex mcp add canopy-api-mcp --url https://mcp.canopyapi.co/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.canopy-api-mcp]
url = "https://mcp.canopyapi.co/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http canopy-api-mcp https://mcp.canopyapi.co/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "canopy-api-mcp": {
      "url": "https://mcp.canopyapi.co/mcp",
      "type": "http"
    }
  }
}
```

## Tools (16)

- `get_amazon_product`
- `get_amazon_product_variants`
- `get_amazon_product_offers`
- `get_amazon_product_stock`
- `get_amazon_product_sales`
- `search_amazon_products`
- `get_amazon_autocomplete`
- `get_amazon_deals`
- `get_amazon_bestsellers`
- `get_amazon_bestseller_categories`
- `get_amazon_categories`
- `get_amazon_category`
- `get_amazon_seller`
- `get_amazon_author`
- `get_amazon_asin_from_gtin`
- `get_amazon_gtin_from_asin`

## FAQ

### 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.
