easyparser-mcp

The official Easyparser MCP server: give your AI agent real-time, structured Amazon data across 21 marketplaces through the Model Context Protocol.

Product details, seller offers, search results, 12-month sales history, Best Sellers Rank, package dimensions, seller legal identities, catalogs, and feedback. 10 data operations plus bulk-job monitoring and account tools, one connection.

What your agent can do

Product data

Tool	What it returns	Cost
`get_product_detail`	Full product profile: title, price, images, rating, BSR, variants, reviews	1 credit (+1 with A+ content)
`get_product_offers`	Every seller offer: prices, conditions, FBA/FBM, Buy Box winner	1 credit per page (max 5)
`get_bestseller_rank`	Current Best Sellers Rank by category	1 credit
`get_package_dimensions`	Exact dimensions, weight, Amazon fee category	1 credit
`get_sales_history`	12-month weekly trends: views, sales, price, BSR	5 credits + 1 per month of history (max 17)

Search & discovery

Tool	What it returns	Cost
`search_products`	Keyword/category results with prices, ratings, badges	1 credit per page (max 5)
`lookup_product`	UPC/EAN/GTIN/ISBN → ASIN conversion	1 credit

Seller intelligence

Tool	What it returns	Cost
`get_seller_profile`	Seller legal name, address, 30/90/365-day feedback trends	1 credit
`get_seller_products`	A seller's full catalog with prices and ratings	1 credit per page (max 5)
`get_seller_feedback`	Individual buyer feedback, filterable by rating/period	1 credit per page (max 5)

Bulk job monitoring: tracks jobs started from the web app or the Bulk API

Tool	What it returns	Cost
`list_bulk_jobs`	Your bulk jobs with progress: status, completed/failed/invalid counts	Free
`get_bulk_job_items`	Per-item outcomes inside a job (debug failed/invalid items)	Free
`get_bulk_item_result`	The parsed data an item produced (retained 24 hours)	Free
`get_bulk_webhook_logs`	Webhook delivery logs for job completions	Free

Error logs: the same data as the Errors page in the web app

Tool	What it returns	Cost
`get_error_logs`	API request errors (real-time and bulk): error code, channel, operation, the failing request params, timestamp	Free

Account & discovery

Tool	What it returns	Cost
`list_operations`	Operations catalog with parameters, costs, and supported domains. Works without a key	Free
`check_credits`	Plan, credit balance, rate limits, and this month's daily usage by operation	Free

Get your API key

Sign up at app.easyparser.com/signup: free tier included, no credit card required. Copy your API key from Account → Plan. Wherever a setup step below asks for YOUR_API_KEY, paste this key.

Setup

Two ways to connect: the hosted remote server (no install, always up to date) or local via npx (runs on your machine).

Cursor

One-click install (opens Cursor with the configuration pre-filled; replace YOUR_API_KEY when prompted):

Remote server: Add to Cursor
Local (npx): Add to Cursor

Or add manually to .cursor/mcp.json:

config.json

{
  "mcpServers": {
    "easyparser": {
      "type": "http",
      "url": "https://mcp.easyparser.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code

One-click install (VS Code asks for your API key securely via an input prompt):

Remote server: Add to VS Code

Or add manually to .vscode/mcp.json:

config.json

{
  "servers": {
    "easyparser": {
      "type": "http",
      "url": "https://mcp.easyparser.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Code

Terminal

claude mcp add --scope user --transport http easyparser https://mcp.easyparser.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop & claude.ai

Add a custom connector:

Open Settings → Connectors → Add → Add custom connector.
Name: Easyparser
Remote MCP server URL: https://mcp.easyparser.com/mcp and click Continue.
Under Authentication, select None (Easyparser uses an API key, not OAuth).
Under Request headers, add a header: name authorization, value Bearer YOUR_API_KEY, marked Required.
Click Add.

Manus

Go to Settings → Integrations → Custom MCP Servers → Add Server and fill in the form:

Field	Value
Server name	`Easyparser`
Transport type	`HTTP`
Server URL	`https://mcp.easyparser.com/mcp`
Custom headers	Header name: `Authorization`, value: `Bearer YOUR_API_KEY` (paste your Easyparser API key after "Bearer ")

Click Test to verify the connection, then Save. The value is always your Easyparser API key; no separate token is needed.

Any MCP client

The hosted endpoint speaks Streamable HTTP at https://mcp.easyparser.com/mcp. Authenticate with Authorization: Bearer YOUR_API_KEY; the x-api-key and api-key headers work too. The list_operations discovery tool works without a key, so agents can explore before signing up.

For local stdio clients, run npx -y easyparser-mcp with EASYPARSER_API_KEY set in the environment.

Example prompts

Code

What is the current price and rating of ASIN B0F25371FH?

Code

Find the ASIN for UPC 041604458187, then show me its 6-month sales trend.

Code

Who is the seller behind this product, what is their legal business name,
and what do their negative reviews say?

Code

Compare the top 10 organic results for "stainless steel water bottle" on
amazon.de: prices, ratings, and which ones are Prime.

Code

Is the bulk job I started this morning finished? If any items failed,
tell me which ASINs and why.

Self-hosting the HTTP server

Terminal

npm install -g easyparser-mcp
PORT=3000 easyparser-mcp-http   # or: node dist/http.js from a clone

Or with Docker:

Terminal

docker build -t easyparser-mcp .
docker run -p 3000:3000 easyparser-mcp

Endpoints: POST /mcp (MCP), GET /health (health check).

How it works

This server is a thin, read-only adapter over the Easyparser Real-Time API. Tool descriptions are written for AI agents: each one states what it returns, when to use it, when a cheaper tool is better, and its credit cost. Every response includes credits_remaining so agents can make budget-aware decisions. Rate-limit and auth errors return actionable guidance (including the signup link) instead of raw HTTP codes.

License

MIT. See LICENSE.