{
  "markdown": "# easyparser-mcp\n\n<div align=\"center\">\n  <br>\n  <picture>\n    <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://easyparser.com/assets/svg/logos/logo-white-2.svg\">\n    <img alt=\"Easyparser\" src=\"https://easyparser.com/assets/svg/logos/logo.svg\" width=\"260\">\n  </picture>\n  <br><br>\n</div>\n\nThe official **Easyparser MCP server**: give your AI agent real-time, structured Amazon data across 21 marketplaces through the [Model Context Protocol](https://modelcontextprotocol.io).\n\nProduct 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.\n\n## What your agent can do\n\n**Product data**\n\n<table>\n<thead><tr><th width=\"220\">Tool</th><th>What it returns</th><th width=\"260\">Cost</th></tr></thead>\n<tbody>\n<tr><td><code>get_product_detail</code></td><td>Full product profile: title, price, images, rating, BSR, variants, reviews</td><td>1 credit (+1 with A+ content)</td></tr>\n<tr><td><code>get_product_offers</code></td><td>Every seller offer: prices, conditions, FBA/FBM, Buy Box winner</td><td>1 credit per page (max 5)</td></tr>\n<tr><td><code>get_bestseller_rank</code></td><td>Current Best Sellers Rank by category</td><td>1 credit</td></tr>\n<tr><td><code>get_package_dimensions</code></td><td>Exact dimensions, weight, Amazon fee category</td><td>1 credit</td></tr>\n<tr><td><code>get_sales_history</code></td><td>12-month weekly trends: views, sales, price, BSR</td><td>5 credits + 1 per month of history (max 17)</td></tr>\n</tbody>\n</table>\n\n**Search & discovery**\n\n<table>\n<thead><tr><th width=\"220\">Tool</th><th>What it returns</th><th width=\"260\">Cost</th></tr></thead>\n<tbody>\n<tr><td><code>search_products</code></td><td>Keyword/category results with prices, ratings, badges</td><td>1 credit per page (max 5)</td></tr>\n<tr><td><code>lookup_product</code></td><td>UPC/EAN/GTIN/ISBN → ASIN conversion</td><td>1 credit</td></tr>\n</tbody>\n</table>\n\n**Seller intelligence**\n\n<table>\n<thead><tr><th width=\"220\">Tool</th><th>What it returns</th><th width=\"260\">Cost</th></tr></thead>\n<tbody>\n<tr><td><code>get_seller_profile</code></td><td>Seller legal name, address, 30/90/365-day feedback trends</td><td>1 credit</td></tr>\n<tr><td><code>get_seller_products</code></td><td>A seller's full catalog with prices and ratings</td><td>1 credit per page (max 5)</td></tr>\n<tr><td><code>get_seller_feedback</code></td><td>Individual buyer feedback, filterable by rating/period</td><td>1 credit per page (max 5)</td></tr>\n</tbody>\n</table>\n\n**Bulk job monitoring**: tracks jobs started from the [web app](https://app.easyparser.com/bulk-requests) or the Bulk API\n\n<table>\n<thead><tr><th width=\"220\">Tool</th><th>What it returns</th><th width=\"260\">Cost</th></tr></thead>\n<tbody>\n<tr><td><code>list_bulk_jobs</code></td><td>Your bulk jobs with progress: status, completed/failed/invalid counts</td><td>Free</td></tr>\n<tr><td><code>get_bulk_job_items</code></td><td>Per-item outcomes inside a job (debug failed/invalid items)</td><td>Free</td></tr>\n<tr><td><code>get_bulk_item_result</code></td><td>The parsed data an item produced (retained 24 hours)</td><td>Free</td></tr>\n<tr><td><code>get_bulk_webhook_logs</code></td><td>Webhook delivery logs for job completions</td><td>Free</td></tr>\n</tbody>\n</table>\n\n**Error logs**: the same data as the [Errors page](https://app.easyparser.com/errors) in the web app\n\n<table>\n<thead><tr><th width=\"220\">Tool</th><th>What it returns</th><th width=\"260\">Cost</th></tr></thead>\n<tbody>\n<tr><td><code>get_error_logs</code></td><td>API request errors (real-time and bulk): error code, channel, operation, the failing request params, timestamp</td><td>Free</td></tr>\n</tbody>\n</table>\n\n**Account & discovery**\n\n<table>\n<thead><tr><th width=\"220\">Tool</th><th>What it returns</th><th width=\"260\">Cost</th></tr></thead>\n<tbody>\n<tr><td><code>list_operations</code></td><td>Operations catalog with parameters, costs, and supported domains. Works <strong>without</strong> a key</td><td>Free</td></tr>\n<tr><td><code>check_credits</code></td><td>Plan, credit balance, rate limits, and this month's daily usage by operation</td><td>Free</td></tr>\n</tbody>\n</table>\n\n## Get your API key\n\nSign up at [app.easyparser.com/signup](https://app.easyparser.com/signup): free tier included, no credit card required. Copy your API key from [Account → Plan](https://app.easyparser.com/account/plan). Wherever a setup step below asks for `YOUR_API_KEY`, paste this key.\n\n## Setup\n\nTwo ways to connect: the **hosted remote server** (no install, always up to date) or **local via npx** (runs on your machine).\n\n### <img src=\"https://cursor.com/favicon.ico\" width=\"18\" height=\"18\" alt=\"Cursor\"> Cursor\n\nOne-click install (opens Cursor with the configuration pre-filled; replace `YOUR_API_KEY` when prompted):\n\n- **Remote server:** [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=easyparser&config=eyJ1cmwiOiJodHRwczovL21jcC5lYXN5cGFyc2VyLmNvbS9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgWU9VUl9BUElfS0VZIn19)\n- **Local (npx):** [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=easyparser&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImVhc3lwYXJzZXItbWNwIl0sImVudiI6eyJFQVNZUEFSU0VSX0FQSV9LRVkiOiJZT1VSX0FQSV9LRVkifX0%3D)\n\nOr add manually to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"easyparser\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.easyparser.com/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_API_KEY\" }\n    }\n  }\n}\n```\n\n### <img src=\"https://code.visualstudio.com/favicon.ico\" width=\"18\" height=\"18\" alt=\"VS Code\"> VS Code\n\nOne-click install (VS Code asks for your API key securely via an input prompt):\n\n- **Remote server:** [Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22easyparser%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//mcp.easyparser.com/mcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24%7Binput%3Aeasyparser-api-key%7D%22%7D%7D)\n\nOr add manually to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"easyparser\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.easyparser.com/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_API_KEY\" }\n    }\n  }\n}\n```\n\n### <img src=\"https://claude.ai/favicon.ico\" width=\"18\" height=\"18\" alt=\"Claude\"> Claude Code\n\n```bash\nclaude mcp add --scope user --transport http easyparser https://mcp.easyparser.com/mcp \\\n  --header \"Authorization: Bearer YOUR_API_KEY\"\n```\n\n### <img src=\"https://claude.ai/favicon.ico\" width=\"18\" height=\"18\" alt=\"Claude\"> Claude Desktop & claude.ai\n\nAdd a custom connector:\n\n1. Open **Settings → Connectors → Add → Add custom connector**.\n2. **Name:** `Easyparser`\n3. **Remote MCP server URL:** `https://mcp.easyparser.com/mcp` and click **Continue**.\n4. Under **Authentication**, select **None** (Easyparser uses an API key, not OAuth).\n5. Under **Request headers**, add a header: name `authorization`, value `Bearer YOUR_API_KEY`, marked **Required**.\n6. Click **Add**.\n\n### <img src=\"https://manus.im/favicon.ico\" width=\"18\" height=\"18\" alt=\"Manus\"> Manus\n\nGo to **Settings → Integrations → Custom MCP Servers → Add Server** and fill in the form:\n\n| Field | Value |\n|---|---|\n| Server name | `Easyparser` |\n| Transport type | `HTTP` |\n| Server URL | `https://mcp.easyparser.com/mcp` |\n| Custom headers | Header name: `Authorization`, value: `Bearer YOUR_API_KEY` (paste your Easyparser API key after \"Bearer \") |\n\nClick **Test** to verify the connection, then **Save**. The value is always your Easyparser API key; no separate token is needed.\n\n### Any MCP client\n\nThe hosted endpoint speaks [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#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.\n\nFor local stdio clients, run `npx -y easyparser-mcp` with `EASYPARSER_API_KEY` set in the environment.\n\n## Example prompts\n\n```\nWhat is the current price and rating of ASIN B0F25371FH?\n```\n\n```\nFind the ASIN for UPC 041604458187, then show me its 6-month sales trend.\n```\n\n```\nWho is the seller behind this product, what is their legal business name,\nand what do their negative reviews say?\n```\n\n```\nCompare the top 10 organic results for \"stainless steel water bottle\" on\namazon.de: prices, ratings, and which ones are Prime.\n```\n\n```\nIs the bulk job I started this morning finished? If any items failed,\ntell me which ASINs and why.\n```\n\n## Self-hosting the HTTP server\n\n```bash\nnpm install -g easyparser-mcp\nPORT=3000 easyparser-mcp-http   # or: node dist/http.js from a clone\n```\n\nOr with Docker:\n\n```bash\ndocker build -t easyparser-mcp .\ndocker run -p 3000:3000 easyparser-mcp\n```\n\nEndpoints: `POST /mcp` (MCP), `GET /health` (health check).\n\n## How it works\n\nThis server is a thin, read-only adapter over the [Easyparser Real-Time API](https://easyparser.gitbook.io/easyparser-documentation). 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.\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n",
  "bytes": 9520,
  "sha": "3d95c54fb6ffb58702ec7ee3375c539f6e725e2fd0590f358600d3986d95ac18",
  "repo_slug": "easyparser-com/mcp-easyparser",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_easyparser_easyparser_776e030d/readme"
}