# Amazon Seller MCP Server - DataDoe > **Hosted Amazon Seller Central & Vendor Central MCP server with read and write access.** Connect Claude, ChatGPT, Cursor, Codex, Gemini, and GitHub Copilot to live Amazon SP-API and Amazon Ads API data, then let your AI agent act on it: update listings, manage orders, and optimize Amazon Ads campaigns. DataDoe handles the SP-API developer approval, OAuth, and rate limits so your AI agent starts working in under a minute. [![Amazon Seller & Vendor](https://img.shields.io/badge/Amazon-Seller%20%26%20Vendor-FF9900?style=flat-square)](https://www.datadoe.com/) [![SP-API Selling Partner API](https://img.shields.io/badge/SP--API-Selling%20Partner-FF6F00?style=flat-square)](https://developer-docs.amazon.com/sp-api/) [![Amazon Ads API](https://img.shields.io/badge/Amazon-Ads%20API-232F3E?style=flat-square)](https://advertising.amazon.com/API/docs) [![MCP Server](https://img.shields.io/badge/MCP-Model%20Context%20Protocol-8A2BE2?style=flat-square)](https://modelcontextprotocol.io/) [![Read and Write](https://img.shields.io/badge/Amazon-Read%20%2B%20Write-2EA043?style=flat-square)](#actions-write-to-amazon) [![AI clients supported](https://img.shields.io/badge/AI%20clients-20%2B%20guides-D97757?style=flat-square)](#quick-setup-per-ai-client) [![smithery badge](https://smithery.ai/badge/jakopv007/datadoe-mcp)](https://smithery.ai/servers/jakopv007/datadoe-mcp) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ๐Ÿ”— [Start a 14-day free trial](https://www.datadoe.com/connect/amazon/mcp) ยท ๐Ÿ“˜ [Documentation](https://www.datadoe.com/hub/docs) ยท โšก [Actions](https://www.datadoe.com/hub/docs/datadoe-features/actions) ยท ๐Ÿ“Š [Amazon data schema](https://www.datadoe.com/hub/data-scheme) ยท ๐ŸŽฅ [Video demo](https://www.youtube.com/watch?v=9YQd7M2dMyY) --- ## ๐Ÿš€ Quick start 1. Sign up at [DataDoe](https://www.datadoe.com/connect/amazon/mcp) and connect your Amazon Seller Central or Vendor Central account. 2. Create a DataDoe MCP API key in [DataDoe MCP Integrations](https://app.datadoe.com/integrations/mcp). 3. Paste the config below into your AI client (Claude, Cursor, Codex, Gemini, GitHub Copilot, ChatGPT, or any MCP-capable tool): ```json { "mcpServers": { "datadoe": { "url": "https://mcp.datadoe.com/mcp/v1", "headers": { "datadoe-mcp-key": "" } } } } ``` 4. Ask your AI agent: *"Show my top 10 ASINs by revenue last month across all Amazon marketplaces."* That's it. DataDoe runs the MCP server on hosted infrastructure, so your team doesn't need to deploy anything locally or wait for Amazon SP-API developer approval. --- ## What is DataDoe MCP? **DataDoe MCP** is a hosted [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for **Amazon sellers, vendors, and agencies**. It exposes your live Amazon Selling Partner API (SP-API) and Amazon Ads API data through MCP tools that work with Claude, ChatGPT, Cursor, Codex CLI, Gemini CLI, GitHub Copilot, Claude Desktop, n8n, NanoClaw, and any other MCP-capable client. DataDoe MCP gives your AI agent two layers over your Amazon account: - **A read layer** - SKU-level orders, sales, ads spend, traffic, inventory, listings, returns, settlements, brand analytics, and catalog, returned as structured tool responses or downloadable CSV and JSON exports. - **A write layer (Actions)** - your agent can change your Amazon account through the SP-API and Amazon Ads API: update listings, cancel orders, confirm shipments, and manage Amazon Ads campaigns, ad groups, targets, and ads. Building your own Amazon SP-API integration typically requires SP-API developer registration, OAuth refresh-token flow, marketplace-specific endpoints, throttling logic, and 2-4 weeks of Amazon approval. DataDoe takes care of all of that. You get a single authenticated MCP URL for both reading and acting on your Amazon data. ![DataDoe MCP - Amazon Seller Central, Vendor Central, and Amazon Ads data for AI agents via SP-API](/assets/datadoe-mcp-banner.png) ## Who is DataDoe MCP for? - **Amazon sellers (FBA, FBM, multi-marketplace)** - get instant answers from your own seller data without context-switching to Seller Central. - **Amazon agencies** managing multiple client accounts - query across every connected Seller Central / Vendor Central account from one MCP server. - **Vendors with Vendor Central** - read 1P data alongside 3P data with the same tools. - **AI builders and developers** - ship Amazon-aware AI agents, dashboards, and internal tools without writing your own SP-API integration. - **Operations teams** - automate recurring reports via Claude Code, Cursor, n8n, or any MCP-capable workflow tool. ## Why use DataDoe MCP? - โœ… **No SP-API approval needed** - DataDoe handles SP-API developer registration, OAuth, refresh tokens, and rate limits on your behalf. - โœ… **30-second setup** - paste the MCP URL and your API key into your AI client config. DataDoe runs the server on hosted infrastructure. - โœ… **20+ documented integrations** out of the box: Claude, ChatGPT, Cursor, Codex, Gemini CLI, GitHub Copilot, n8n, CrewAI, the Claude & OpenAI Agent SDKs, Excel / Word / PowerPoint via Claude, and any other MCP-capable client. - โœ… **SKU-level resolution** - drill into individual ASINs, parent listings, marketplaces, time periods, ad campaigns, keyword reports, settlements, returns. - โœ… **Multi-marketplace, multi-account** - one MCP server covers every Amazon marketplace (US, UK, DE, FR, IT, ES, CA, AU, JP, MX, and more) across Seller Central and Vendor Central. - โœ… **AI-native by design** - `exports_create` accepts SQL-like filter groups, GROUP BY, aggregations, and date intervals, so your AI agent can build complex reports from one tool call. - โœ… **One plan, one price** - $97/month with a 14-day free trial. See [pricing](https://www.datadoe.com/pricing). - โœ… **Read and write** - with [Actions](#actions-write-to-amazon), your agent doesn't just report, it updates listings, manages orders, and optimizes Amazon Ads, with a `dryRun` validation step and per-type controls. - โœ… **Always-on hosted infrastructure** - DataDoe manages SP-API rate limits, token rotation, and ongoing maintenance. ## What can you ask DataDoe MCP? Example questions your AI agent can answer with DataDoe MCP connected: - *"What were my top 20 ASINs by revenue last month across all Amazon marketplaces?"* - *"Reconcile my Amazon settlements against orders for Q1, and show any discrepancies."* - *"Which Amazon Ads campaigns had ACoS over 40% last week, and what was their total spend?"* - *"Show inventory units at risk of stocking out in the next 14 days."* - *"Build me a daily KPI dashboard with sales, traffic, and ad spend for the last 90 days."* - *"Which search terms in my PPC reports drove the most clicks but zero conversions?"* - *"Pull every Amazon return for SKU ABC-123 in the last 60 days and summarize the return reasons."* - *"Compare my brand analytics search term share-of-voice month over month."* And with **Actions** enabled, your agent can act on what it finds: - *"Raise the daily budget on my top-ACoS Sponsored Products campaign by 20%."* - *"Pause every campaign with ACoS over 50% last week."* - *"Update the price of SKU ABC-123 to 19.99 and refresh its bullet points."* - *"Confirm shipment for order 123-4567890-1234567 with UPS tracking 1Z999..."* ## Actions: write to Amazon Actions let your AI agent make changes on your connected Amazon Seller Central, Vendor Central, and Amazon Ads accounts through the SP-API and Amazon Ads API. Every Action is recorded and auditable. What your agent can do: - **Listings** - update the title, bullet points, description, generic keyword, item-type keyword, and images (`AMAZON_LISTINGS_UPDATE`), update prices for Seller Central accounts (`AMAZON_LISTINGS_PRICING_UPDATE`), and preview a listing write with the matching `*_VERIFY` Action before submitting it. - **Orders** - cancel an order item, confirm shipment, buy shipping, solicit a review, message the buyer, or search current orders (`AMAZON_ORDERS_FIND`) and order metrics (`AMAZON_ORDERS_GET_METRICS`). - **Vendor Central** - acknowledge purchase orders, submit shipments, and retrieve labels, packing slips, and transaction status. - **Amazon Ads** - add, update, remove, and find campaigns, ad groups, targets, ads, ad associations, and Sponsored Products bid rules across Sponsored Products, Brands, Display, TV, and Amazon DSP. How it works - the agent runs each Action through these MCP tools: 1. `actions_details_schema_get` - get the payload schema for the Action type. 2. `actions_start` with `dryRun=true` - validate the payload without executing. 3. `actions_start` - run the Action and get an action id. 4. `actions_get` - poll until it completes, then read the `result`. Use `actions_list` to review past Actions (filter by status, type, creator, and date). Action types are disabled by default and enabled per type in [Settings > Actions](https://app.datadoe.com/settings?tab=actions). When a type is disabled, `actions_start` rejects live runs but still allows `dryRun` validation. Example `details` payload for `AMAZON_LISTINGS_UPDATE`: ```json { "type": "AMAZON_LISTINGS_UPDATE", "sellerOrVendorId": "", "dryRun": true, "details": { "changes": [ { "sku": "ABC-123", "language_tag": "en_US", "name": "Stainless Steel Water Bottle 750ml", "bulletPoints": ["Keeps drinks cold for 24 hours", "Leak-proof lid"] } ] } } ``` Running an Action costs 3 AI Tokens for up to 100 changes, plus 1 AI Token per additional 100 changes. See the [Actions docs](https://www.datadoe.com/hub/docs/datadoe-features/actions) for the full catalog and payload schemas. ## Available MCP tools DataDoe MCP exposes the following tools to your AI client: | Tool | Category | What it does | |---|---|---| | `sellers_and_vendors_list` | Account | Lists Amazon sellers and vendors connected to your DataDoe organization, with account type, marketplace, and connection details. | | `sellers_and_vendors_get` | Account | Returns one seller or vendor, including whether a connection needs reauthorization. | | `sellers_and_vendors_rename` | Account | Renames a seller or vendor. Names are unique within the organization. | | `sellers_and_vendors_invitation_create` | Account | Creates a one-time link to connect a new Amazon account or reconnect an existing one. | | `sellers_and_vendors_invitations_get` | Account | Lists pending invitations, or returns one invitation and its status. | | `sellers_and_vendors_invitation_revoke` | Account | Revokes a pending invitation so its link can no longer be used. | | `organization_and_subscription_details_get` | Account | Returns your DataDoe organization profile, subscription plan, billing health, and AI Token balances. | | `exports_sources_get` | Data | Searches DataDoe's catalog of Amazon data export sources (orders, sales and traffic, ads performance, inventory, listings, settlements, returns, brand analytics, and more) by keyword. | | `exports_source_get` | Data | Returns the columns (paginated) and metadata of one export source, including whether a date period is required. | | `exports_create` | Data | Creates an Amazon data export from any source. Supports SQL-like filters, HAVING, GROUP BY, aggregations (sum / avg / count / countDistinct / min / max), date intervals (DAY / WEEK / MONTH), pagination, and CSV or JSON output. | | `exports_get` | Data | Returns status and metadata for an in-flight or completed export job. | | `exports_list` | Data | Lists export jobs for the organization with pagination and optional export ID filters. | | `exports_raw_url_get` | Data | Returns a download URL for a completed export, valid until 15 minutes after the export was created. | | `exports_raw_download` | Data | Returns the raw export content (CSV or JSON) inline in the tool response. | | `exports_delete` | Data | Deletes an export by its ID. | | `files_create` | Files | Creates and uploads a utility file (listing images, A+ images, or order-message files) as base64-encoded content. | | `files_list` | Files | Lists utility files for the organization with pagination and filters. | | `files_get` | Files | Returns metadata for a utility file by id. | | `files_download_url_get` | Files | Returns a download URL for an uploaded file, valid until 15 minutes after the file was created. | | `files_delete` | Files | Deletes a utility file and its stored object when present. | | `datadoe_user_docs_table_of_contents_get` | Docs | Returns the table of contents of the DataDoe user documentation, useful when an agent needs to look up features or capabilities on demand. | | `datadoe_user_docs_page_get` | Docs | Returns the full content of a named DataDoe documentation page. | | `actions_details_schema_get` | Actions | Returns the JSON Schema of the `details` payload, the access mode (READ or WRITE), whether that Action type is enabled, and the start tool. | | `actions_start` | Actions | Starts a READ or WRITE Action on your Amazon account (listings, orders, A+ Content, Multi-Channel Fulfillment, Amazon Ads). Set `dryRun=true` to validate without executing. Returns an action id. | | `actions_get` | Actions | Returns the status and `result` of an Action by id; poll after `actions_start`. | | `actions_list` | Actions | Returns paginated Action history, filterable by status, type, creator, and date. | | `cogs_upsert` | COGS | Creates or updates cost-of-goods-sold rows for a Seller Central account. | | `cogs_delete` | COGS | Deletes COGS rows for a Seller Central account with optional filters. | | `vendor_code_upsert` | Vendor codes | Creates or updates vendor code rows for an account with a Vendor Central connection. | | `vendor_code_delete` | Vendor codes | Deletes vendor code rows for an account with a Vendor Central connection, with optional filters. | | `sqp_asins_get` | SQP | Returns the Search Query Performance (SQP) ASIN list of a Seller Central account. DataDoe stores up to 252 ASINs. | | `sqp_asins_add` | SQP | Adds up to 252 ASINs per call to the SQP list of a Seller Central account. | | `sqp_asins_remove` | SQP | Removes up to 252 ASINs per call from the SQP list of a Seller Central account. | | `plugins_get` | Plugins | Returns the Memories and Skills saved in the organization, plus ready Files for the user. | | `plugins_memories_create` | Plugins | Creates a memory Plugin for the user or organization. | | `plugins_memories_edit` | Plugins | Updates a memory Plugin for the user or organization. | | `plugins_memories_delete` | Plugins | Deletes a memory Plugin for the user or organization. | | `plugins_skills_get` | Plugins | Returns a Skill element (SKILL.md or supporting file) listed by plugins_get. | | `plugins_files_get` | Plugins | Returns converted markdown content for a File plugin listed by plugins_get. | | `amc_workflows_find` | AMC | Lists live Amazon Marketing Cloud (AMC) workflows with their schedules and state hash. | | `amc_workflows_create` | AMC | Creates an AMC workflow (SQL with optional Daily or Weekly schedules) without running it. | | `amc_workflows_update` | AMC | Updates the SQL and/or schedules of an AMC workflow. | | `amc_workflows_delete` | AMC | Deletes an AMC workflow and its schedules. | | `amc_query_validate` | AMC | Dry-runs a workflow, raw SQL, or a query template against Amazon without starting an execution. | | `amc_query_start` | AMC | Starts an on-demand AMC query from a workflow, raw SQL, or a query template. | | `amc_query_cancel` | AMC | Cancels a pending or running AMC query. | | `amc_query_results_find` | AMC | Lists AMC query result history with filters. | | `amc_query_result_get` | AMC | Returns one AMC query result, including short-lived download URLs when it is available. | | `amc_schema_find` | AMC | Reads the live AMC schema: a table index, or the fields of one data source. | | `amc_operation_get` | AMC | Returns the status of an asynchronous AMC operation, such as a workflow change or an uncertain query start. | | `amc_query_templates_find` | AMC | Lists ready-made AMC query templates and, when an account is selected, whether that account can run each one. | | `amc_query_template_get` | AMC | Returns one AMC query template, including its SQL. | | `datadoe_support_ticket_create` | Support | Sends a support request to the DataDoe team. | | `datadoe_support_ticket_check` | Support | Reads a support request and any reply. Poll about once an hour. | | `datadoe_support_ticket_update` | Support | Adds more information to an existing support request. | Amazon Marketing Cloud (AMC) tools are available by request only and are listed by the live server only after access is granted. See [Amazon Marketing Cloud](https://www.datadoe.com/hub/docs/datadoe-features/amc). --- ## Quick setup per AI client The snippets below are the minimum config you need. For step-by-step guides per AI client, see the [Per-client setup guides](#per-client-setup-guides) list at the end of this section. ### Claude.ai ยท Claude Desktop Add DataDoe as a custom connector: open **Customize > Connectors**, click **Add**, and paste `https://mcp.datadoe.com/mcp/v1` as the MCP Server URL. Claude signs in to DataDoe with OAuth, so you do not need an API key. See [Using Claude](https://www.datadoe.com/hub/docs/datadoe-mcp/claude). ### Claude Code ```bash claude mcp add datadoe "https://mcp.datadoe.com/mcp/v1" --transport http --header "datadoe-mcp-key: " ``` The server name and URL must come before `--header`. You can also omit `--header` and sign in with OAuth by running `/mcp` in Claude Code and choosing **Authenticate**. ### Cursor Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per project): ```json { "mcpServers": { "datadoe": { "url": "https://mcp.datadoe.com/mcp/v1", "headers": { "datadoe-mcp-key": "" } } } } ``` ### GitHub Copilot (VS Code) Add to `.vscode/mcp.json` (per project) or your user MCP configuration (**MCP: Open User Configuration**): ```json { "servers": { "datadoe": { "type": "http", "url": "https://mcp.datadoe.com/mcp/v1", "headers": { "datadoe-mcp-key": "" } } } } ``` ### Codex CLI ยท Gemini CLI ยท ChatGPT ยท n8n ยท NanoClaw ยท any other MCP client DataDoe MCP works as a **generic remote MCP server**. Configure your client with: - **URL**: `https://mcp.datadoe.com/mcp/v1` - **Transport**: HTTP Streamable - **Auth header**: `datadoe-mcp-key: ` (create a key in [DataDoe MCP Integrations](https://app.datadoe.com/integrations/mcp)) ### Per-client setup guides For step-by-step setup guides per AI client, see the dedicated DataDoe documentation pages: - [Using Claude](https://www.datadoe.com/hub/docs/datadoe-mcp/claude) - [Using ChatGPT](https://www.datadoe.com/hub/docs/datadoe-mcp/chatgpt) - [Using Claude Code](https://www.datadoe.com/hub/docs/datadoe-mcp/claude-code) - [Using Claude Agent SDK](https://www.datadoe.com/hub/docs/datadoe-mcp/claude-agents-sdk) - [Using Codex](https://www.datadoe.com/hub/docs/datadoe-mcp/codex) - [Using Codex Sites](https://www.datadoe.com/hub/docs/datadoe-mcp/codex-sites) - [Using CrewAI](https://www.datadoe.com/hub/docs/datadoe-mcp/crewai) - [Using Cursor](https://www.datadoe.com/hub/docs/datadoe-mcp/cursor) - [Using Excel + Claude](https://www.datadoe.com/hub/docs/datadoe-mcp/excel) - [Using Gemini CLI](https://www.datadoe.com/hub/docs/datadoe-mcp/gemini-cli) - [Using Gumloop](https://www.datadoe.com/hub/docs/datadoe-mcp/gumloop) - [Using Hermes Agent](https://www.datadoe.com/hub/docs/datadoe-mcp/hermes) - [Using n8n](https://www.datadoe.com/hub/docs/datadoe-mcp/n8n) - [Using NanoClaw](https://www.datadoe.com/hub/docs/datadoe-mcp/nanoclaw) - [Using OpenAI Agents SDK](https://www.datadoe.com/hub/docs/datadoe-mcp/openai-agents-sdk) - [Using OpenClaw](https://www.datadoe.com/hub/docs/datadoe-mcp/openclaw) - [Using OpenCode](https://www.datadoe.com/hub/docs/datadoe-mcp/opencode) - [Using PowerPoint + Claude](https://www.datadoe.com/hub/docs/datadoe-mcp/powerpoint) - [Using VS Code](https://www.datadoe.com/hub/docs/datadoe-mcp/vs-code) - [Using Word + Claude](https://www.datadoe.com/hub/docs/datadoe-mcp/word) Full documentation root: [www.datadoe.com/hub/docs](https://www.datadoe.com/hub/docs) --- ## What Amazon data is available? DataDoe MCP exposes every Amazon data table available in DataDoe, 130+ tables across Seller Central, Vendor Central and Amazon Ads, including: - **Orders & sales**: order line items, order performance, sales and traffic, refunds - **Amazon Ads**: campaigns, ad groups, keywords, search terms, sponsored products / brands / display, ACoS / ROAS / impression-share metrics - **Inventory**: FBA inventory, restock recommendations, stranded inventory, age, units at risk - **Listings & catalog**: ASIN catalog, product attributes, buy box ownership, variations - **Finance**: settlements, fees, reserves, reimbursements, deposits - **Returns**: customer returns, return reasons, FBA returns - **Brand analytics**: search query performance, market basket, repeat purchase, demographics - **Traffic**: sessions, page views, conversion rate, by ASIN, by marketplace Full schema: [www.datadoe.com/hub/data-scheme](https://www.datadoe.com/hub/data-scheme) --- ## What DataDoe MCP is NOT To avoid confusion when evaluating Amazon MCP servers: - โŒ **Not a self-hosted MCP server.** DataDoe MCP is hosted at `mcp.datadoe.com`. This GitHub repository is the schema facade used to publish DataDoe MCP to public MCP registries (Official MCP Registry, mcpservers.org, glama.ai, mcpmarket.com, Cline, smithery.ai, and others). - โŒ **Not an SP-API wrapper you operate yourself.** DataDoe owns the SP-API developer registration, OAuth flow, refresh-token rotation, marketplace endpoints, and rate-limit handling. You bring your Amazon account; we handle the rest. - โŒ **Not a free open-source server.** DataDoe MCP is part of a DataDoe subscription: $97/month, with a 14-day free trial. --- ## Documentation & resources - [DataDoe homepage](https://www.datadoe.com/) - [DataDoe documentation](https://www.datadoe.com/hub/docs) - [DataDoe Actions (write to Amazon)](https://www.datadoe.com/hub/docs/datadoe-features/actions) - [Amazon data schema reference](https://www.datadoe.com/hub/data-scheme) - [DataDoe MCP product page](https://www.datadoe.com/connect/amazon/mcp) - [DataDoe vs Amazon MCP comparison](https://www.datadoe.com/compare/datadoe-vs-amazon-mcp) - [DataDoe MCP video demo](https://www.youtube.com/watch?v=9YQd7M2dMyY) - [DataDoe blog: Amazon SP-API, Ads API, and MCP explainers](https://www.datadoe.com/blog) - [Create a DataDoe MCP API key](https://app.datadoe.com/integrations/mcp) --- ## License [MIT](LICENSE). The DataDoe MCP schema facade in this repository is open-source. The hosted MCP server, DataDoe application, and DataDoe infrastructure are proprietary and provided by DataDoe, Inc. --- ### How to start and connect locally (for indexing and listing) > This server is just a schema facade of the actual DataDoe MCP server, made for exposing DataDoe MCP to various MCP registries. > It is a no-op server: it does not do anything beyond exposing the schema of DataDoe MCP. > If you want to actually use DataDoe MCP, see the [DataDoe MCP documentation](https://www.datadoe.com/hub/docs). #### 1. Install dependencies ```bash yarn install ``` #### 2. Build the local server ```bash yarn build ``` This compiles the TypeScript source into `dist/index.js`. #### 3. Start the server ```bash yarn start ``` The server communicates over stdio, so the process is intended to be launched by your MCP client rather than opened in a browser. #### 4. Connect from an MCP client For a local setup, point your client at the built entrypoint. A typical `mcp.json` looks like this: ```json { "mcpServers": { "datadoe": { "command": "node", "args": ["/absolute/path/to/datadoe-mcp/dist/index.js"] } } } ``` If your client supports environment-based workspace paths, you can usually swap the absolute path for the actual clone location on your machine. --- DataDoe is a product of DataDoe, Inc. ยท [datadoe.com](https://www.datadoe.com/)