MCP Server

Connect your AI agent to Easyparser's real-time Amazon data through the Model Context Protocol with no custom integration code required

Overview

The Easyparser MCP server exposes Easyparser's real-time Amazon data across 21 marketplaces directly to AI agents through the Model Context Protocol. Instead of writing request/response handling against the Real-Time API, you connect your agent (Claude, Cursor, VS Code, Manus, or any MCP-compatible client) to a single endpoint, and the agent gets access to every supported operation as a callable tool.

The server is a thin, read-only adapter over the Easyparser Real-Time API. Each tool description is written for AI agents: what it returns, when to use it, when a cheaper tool is a better fit, and its credit cost. Every response includes credits_remaining so agents can make budget-aware decisions, and rate-limit or auth errors return actionable guidance instead of raw HTTP status codes.

The MCP server is a wrapper around the same operations documented under Real-Time Integration. Credit costs, marketplaces, and data shapes are identical: this page only covers connecting an agent to it.

Available Tools

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

There are two ways to connect:

• Hosted remote server: no install, always up to date. Endpoint: https://mcp.easyparser.com/mcp.

• Local via npx: runs on your machine, useful for stdio-only clients.

Cursor

One-click install links are available from the GitHub repository for both the remote server and the local (npx) variant. They open Cursor with the configuration pre-filled; replace YOUR_API_KEY when prompted.

Or add manually to .cursor/mcp.json:

.cursor/mcp.json

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

VS Code

A one-click install link is available from the GitHub repository for the remote server. VS Code asks for your API key securely via an input prompt.

Or add manually to .vscode/mcp.json:

.vscode/mcp.json

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

Claude Code

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:

1. Open Settings → Connectors → Add → Add custom connector.

2. Name: Easyparser

3. Remote MCP server URL: https://mcp.easyparser.com/mcp, then click Continue.

4. Under Authentication, select None (Easyparser uses an API key, not OAuth).

5. Under Request headers, add a header: name authorization, value Bearer YOUR_API_KEY, marked Required.

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

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 the catalog before signing up.

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

Example Prompts

What is the current price and rating of ASIN B0F25371FH?

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

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

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

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

Self-Hosting the HTTP Server

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

Or with Docker:

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

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

Ready to Dive In?

Connect your favorite MCP client using the steps above, or explore the underlying Real-Time Integration operations directly if you'd rather build a custom integration.