Asin

dev.asinPublished by asin.devOfficial publisherv0.1.0Updated Nov 7, 2026

Track Amazon prices and products with a scheduled watchlist, price history, offers and alerts.

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Official Asin MCP server that lets an assistant track Amazon products and prices: watchlist, price history, offers and alerts.

What you can do
  • Search Amazon and add products to a watchlist from an ASIN, link or short link
  • List tracked products with latest state and price trend, and read a product's full price history
  • Read current offers and seller prices, and look up price history for any ASIN on a marketplace
  • Trigger an immediate check, or update target price, drop alerts, check interval or pause state
  • Delete a product with its price history, and view plan, remaining credits and monthly credit usage
When to use it
Useful when you want an assistant to monitor Amazon prices, compare offers, or answer questions about a product's price history and tracked items without leaving the chat.
Requirements
An Asin API key, sent as a Bearer token in the Authorization header for the hosted endpoint or set in ASIN_API_KEY for the local stdio package. The local package needs Node.js 20 or newer; Docker is also supported. Network access to the Asin API is required.
Before you install
Every tool that calls the API consumes credits, and some actions (immediate checks, offer reads) cost credits per call; deleting a product also removes its price history. The API key is a secret and should be kept out of shared configs. A self-hosted HTTP server should sit behind TLS before being exposed.

Installation

In SourceWeft

  1. Open Asin in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dev.asin%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "asin": {
      "type": "http",
      "url": "https://www.asin.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

Asin MCP Server

Official Model Context Protocol server for the Asin Amazon price tracking API.

Track Amazon prices and products with a scheduled watchlist, price history, offers and alerts.

It lets Claude, Cursor, VS Code, Windsurf and any MCP client call the API as tools. Runs over stdio (local) or Streamable HTTP (self-hosted).

Requirements

  • Node.js 20 or newer
  • a Asin API key — sign up, then copy it from the dashboard

Hosted server (recommended)

Asin runs this server for you at https://www.asin.dev/api/mcp (Streamable HTTP). Send your API key as a Bearer token in the Authorization header; nothing to install.

sh
claude mcp add --transport http asin https://www.asin.dev/api/mcp --header "Authorization: Bearer YOUR_API_KEY"
json
{  "mcpServers": {    "asin": {      "url": "https://www.asin.dev/api/mcp",      "headers": {        "Authorization": "Bearer YOUR_API_KEY"      }    }  }}

The hosted server and this package expose the same API; run the package locally when you want stdio, your own network egress, or to self-host it.

Run it locally

Claude Code

sh
claude mcp add asin --env ASIN_API_KEY=YOUR_API_KEY -- npx -y @asindev/mcp

Claude Desktop, Cursor, Windsurf and other clients

Add the server to the client's MCP configuration (claude_desktop_config.json, .cursor/mcp.json…):

json
{  "mcpServers": {    "asin": {      "command": "npx",      "args": ["-y", "@asindev/mcp"],      "env": {        "ASIN_API_KEY": "YOUR_API_KEY"      }    }  }}

VS Code

json
{  "servers": {    "asin": {      "type": "stdio",      "command": "npx",      "args": ["-y", "@asindev/mcp"],      "env": {        "ASIN_API_KEY": "${input:asin-api-key}"      }    }  },  "inputs": [    {      "type": "promptString",      "id": "asin-api-key",      "description": "Asin API key",      "password": true    }  ]}

Claude Desktop extension

Download the .mcpb bundle from the releases page and open it; Claude Desktop asks for your API key.

Docker

sh
docker build -t asin-mcp .docker run -i --rm -e ASIN_API_KEY=YOUR_API_KEY asin-mcp

Tools

ToolDescription
check_productAsks for a check right away (1 credit), at most once per 5 minutes; earlier calls return the product unchanged. A paused product has to be resumed first. The check runs in the background; with wait=t…
delete_productRemoves the product and its price history.
fetch_offersReads the offers on Amazon for 1 credit, refunded if it doesn't answer. A read made in the last 3 hours, by anyone, is returned instead, for free (charged: false). The answer is the same as GET /offe…
get_accountYour plan, the credits left (monthly allowance and packs), how many products you track and the credits they use per month.
get_asin_historyEvery price Asin read for an ASIN on a marketplace over the period, whoever tracks it, oldest first, with the lowest, highest and average of those prices. A history of more than 5000 points is thinne…
get_offersWho sells the product and at what price, as last read, cheapest first, with Amazon's own price and the cheapest new and used offers (used is only known for Amazon's own outlet). Free: this never read…
get_productThe product's latest state and every price read of the period, oldest first. The history covers every read of this ASIN on this marketplace, including those made before you added it, so a product add…
list_productsYour watchlist, newest first, with each product's latest state and its recent prices (trend). Filter with asin (and marketplace) to know if a product is tracked, or with filter to get the same lists…
search_amazonAmazon search results (up to 60, sponsored included), to find the ASIN of a product. Free, limited to 30 searches per hour.
track_productAdds an ASIN, an Amazon link or a short link (amzn.to, a.co…) to your watchlist. The first check runs in the background within seconds (checking is true until then): poll GET /products/{id}, or send…
update_productTarget price, drop alerts, check interval, or pause. Send only what changes.

Every tool that calls the API consumes credits. JSON results are returned as text; images are returned inline and other files (PDF…) as embedded resources, up to 4 MB.

Streamable HTTP

sh
npx @asindev/mcp --http --port 3000

The endpoint is POST /mcp (stateless, JSON responses). Each client sends its own key in the x-api-key header (or Authorization: Bearer <key>); the server never uses a key of its own. It binds to 127.0.0.1 by default and rejects browser origins unless you allow them — put it behind TLS before exposing it.

createHttpHandler() is exported for Fetch-compatible runtimes (Cloudflare Workers, Deno, Bun):

ts
import { createHttpHandler } from "@asindev/mcp";
export default { fetch: createHttpHandler({ allowedOrigins: [] }) };

Security

  • The API key is read from ASIN_API_KEY (stdio) or the request headers (HTTP) and removed from error messages.
  • Content fetched from websites is untrusted: the server instructions tell the model to treat it as data, not instructions.
  • See SECURITY.md to report a vulnerability.

Development

sh
npm installnpm testnpm run buildnpx @modelcontextprotocol/inspector node dist/stdio.js

Built on the SDK

The server uses the official Node.js SDK (@asindev/sdk).

All Asin SDKs

SDKPackageInstall
Node.js@asindev/sdknpm install @asindev/sdk
Pythonasindotdevpip install asindotdev
Goasin-gogo get github.com/asindotdev/asin-go
.NETAsindotnet add package Asin
Rubyasindotdevgem install asindotdev
PHPasindotdev/sdkcomposer require asindotdev/sdk
Javaasin-javabuild from source, see its README
CLI@asindev/clinpm install -g @asindev/cli
MCP server@asindev/mcpnpx -y @asindev/mcp

License

MIT — see LICENSE.

Source: README.md at commit d28f901

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

1
  1. v0.1.0LatestNov 7, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Asin integrations