> For the complete documentation index, see [llms.txt](https://easyparser.gitbook.io/easyparser-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://easyparser.gitbook.io/easyparser-documentation/amazon/mcp-server.md).

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

{% hint style="info" %}
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.
{% endhint %}

### 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](https://app.easyparser.com/bulk-requests) 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](https://app.easyparser.com/errors) 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](https://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](https://github.com/easyparser-com/mcp-easyparser) 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`:

{% code title=".cursor/mcp.json" overflow="wrap" %}

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

{% endcode %}

#### VS Code

A one-click install link is available from the [GitHub repository](https://github.com/easyparser-com/mcp-easyparser) for the remote server. VS Code asks for your API key securely via an input prompt.

Or add manually to `.vscode/mcp.json`:

{% code title=".vscode/mcp.json" overflow="wrap" %}

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

{% endcode %}

#### Claude Code

{% code overflow="wrap" %}

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

{% endcode %}

#### 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](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.

{% hint style="info" %}
The `list_operations` discovery tool works without a key, so agents can explore the catalog before signing up.
{% endhint %}

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

{% code overflow="wrap" %}

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

{% endcode %}

Or with Docker:

{% code overflow="wrap" %}

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

{% endcode %}

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](/easyparser-documentation/real-time-integration/overview.md) operations directly if you'd rather build a custom integration.