Skip to main content
Glama
Sign In
Asin MCP Server

Asin MCP Server

by asindotdev
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

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

Related MCP server: Amazon MCP Server

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.

claude mcp add --transport http asin https://www.asin.dev/api/mcp --header "Authorization: Bearer YOUR_API_KEY"
{
  "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

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…):

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

VS Code

{
  "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

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

Tools

Tool

Description

check_product

Asks 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_product

Removes the product and its price history.

fetch_offers

Reads 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_account

Your plan, the credits left (monthly allowance and packs), how many products you track and the credits they use per month.

get_asin_history

Every 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_offers

Who 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_product

The 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_products

Your 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_amazon

Amazon search results (up to 60, sponsored included), to find the ASIN of a product. Free, limited to 30 searches per hour.

track_product

Adds 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_product

Target 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

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):

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

npm install
npm test
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.js

Built on the SDK

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

All Asin SDKs

SDK

Package

Install

Node.js

@asindev/sdk

npm install @asindev/sdk

Python

asindotdev

pip install asindotdev

Go

asin-go

go get github.com/asindotdev/asin-go

.NET

Asin

dotnet add package Asin

Ruby

asindotdev

gem install asindotdev

PHP

asindotdev/sdk

composer require asindotdev/sdk

Java

asin-java

build from source, see its README

CLI

@asindev/cli

npm install -g @asindev/cli

MCP server

@asindev/mcp

npx -y @asindev/mcp

License

MIT — see LICENSE.

Available Tools

11 tools
check_productCheck the price nowAInspect

Check the price now. Asks 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=true the answer waits for it. Read last_e…

Inputs: id (required), wait.

delete_productStop tracking a productA
Destructive
Inspect

Stop tracking a product. Removes the product and its price history.

Inputs: id (required).

fetch_offersRead every offer from AmazonAInspect

Read every offer from Amazon. Reads 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 /offers.

Inputs: asin (required), refresh, marketplace.

get_accountPlan and remaining creditsB
Read-only
Inspect

Plan and remaining credits. Your plan, the credits left (monthly allowance and packs), how many products you track and the credits they use per month.

Inputs: no named parameters.

get_asin_historyPrice history of any ASINB
Read-only
Inspect

Price history of any ASIN. Every 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 thinned evenly, keeping its first and last poi…

Inputs: asin (required), days, marketplace.

get_offersOffers already knownA
Read-only
Inspect

Offers already known. Who 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 reads Amazon or spends a credit. When nobody…

Inputs: asin (required), marketplace.

get_productGet a product and its price historyB
Read-only
Inspect

Get a product and its price history. The 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 added today can come with months of prices;…

Inputs: id (required), days.

list_productsList tracked productsA
Read-only
Inspect

List tracked products. Your 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 as the app's tabs.

Inputs: asin, page, limit, filter, +1 more.

search_amazonSearch AmazonA
Read-only
Inspect

Search Amazon. Amazon search results (up to 60, sponsored included), to find the ASIN of a product. Free, limited to 30 searches per hour.

Inputs: query (required), marketplace.

track_productTrack a productAInspect

Track a product. Adds 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 wait: true to get the answer once it's d…

Inputs: product (required), wait, marketplace, target_price, +1 more.

update_productChange alerts and checksAInspect

Change alerts and checks. Target price, drop alerts, check interval, or pause. Send only what changes.

Inputs: id (required), paused, target_price, alert_on_drop, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.8/5.0

    Scored across 11 tools

    Disambiguation4/5

    Most tools target clearly different actions/resources: search, track, list, get, update, delete, check, and account. The main potential confusion is between get_offers (cached/free) and fetch_offers (fresh Amazon read/credit), and to a lesser extent get_product versus get_asin_history, but the descriptions make the distinctions reasonably clear.

    Naming Consistency5/5

    All tool names use snake_case with a leading verb and a resource-oriented noun phrase. The pattern is consistent across get/fetch/list/search/track/check/update/delete operations.

    Tool Count5/5

    Eleven tools is well-scoped for an Amazon price-tracking server, covering search, tracking lifecycle, offers, price history, checks, and account status. Each tool corresponds to a meaningful operation rather than redundant surface area.

    Completeness4/5

    The lifecycle for tracked products is covered: search, track, list, get, update, delete, plus price checks, offers, history, and account information. Minor gaps may exist around bulk operations or explicit offer retrieval for arbitrary untracked ASINs, but core workflows are covered.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers