English Français العربية

Nova Amazon MCP Server

السجل الرسمي التسويق والمبيعات

Amazon Seller Central, Vendor Central and Ads data, profit-ready, for Claude, ChatGPT and any AI

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http nova-amazon-mcp-server 'https://mcp.novadata.io/api/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "nova-amazon-mcp-server": {
            "type": "http",
            "url": "https://mcp.novadata.io/api/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Nova Amazon MCP Server
  2. What it is
  3. Why a data layer rather than raw Amazon APIs
  4. Setup
  5. Tools
  6. Example prompts
  7. How it differs from Amazon's own MCP servers
  8. Security and permissions
  9. Links
  10. Contributing
  11. License

Nova Amazon MCP Server

Connect Amazon Seller Central, Vendor Central, Amazon Ads and DSP data to Claude, ChatGPT, Microsoft Copilot, Grok, Gemini or Cursor through the Model Context Protocol, and ask questions in plain language.

Which SKUs lost the most net profit versus last month, and why?
Which search terms spent more than $100 last week with zero sales?
What runs out of stock in the next three weeks across all marketplaces?

This repository is the setup kit and reference for Nova MCP, a hosted MCP server. It contains ready to paste client configurations, the tool reference and an example prompt library. The server itself is a commercial service operated by Nova; this repo does not contain server code.

What it is
Endpointhttps://mcp.novadata.io/api/mcp
TransportRemote, Streamable HTTP
AuthOAuth 2.0 with dynamic client registration, per Amazon account, revocable in Nova
Amazon dataSeller Central (3P), Vendor Central (1P), Amazon Ads, Amazon DSP, Search Query Performance, reviews, Subscribe & Save
Marketplaces23 Amazon marketplaces
FreshnessOrders and units within seconds of the sale. Finance transactions hourly, ad spend every two hours, search terms three times a day, other reports daily
AssistantsClaude, ChatGPT, Microsoft Copilot, Grok, Gemini, Cursor, and any MCP client
PricingCommercial. From $49/month per Amazon account, 14 day free trial, no card

Why a data layer rather than raw Amazon APIs

Amazon's Selling Partner, Vendor and Advertising APIs return raw reports split across many endpoints, with no reconciliation between them. An assistant pointed at them spends its context paginating and joining, and two questions can get two different numbers.

Nova MCP exposes a pre-modelled layer instead: orders, settlements and every Amazon fee reconciled at SKU level, your own costs applied (COGS, FBM shipping, VAT), Sponsored ads down to the customer search term, DSP by order and line item, FBA and AWD inventory with days of cover, listing health and Buy Box, Best Seller Rank. Filtering and ranking run server side, so one seller question is usually one tool call, and the answer matches the Nova dashboard.

Setup

You need a Nova account with at least one Amazon account connected. Start a trial at novadata.io if you do not have one.

The server URL is identical everywhere. Each client adds it in its own connector settings.

Tools

52 tools. Full reference in docs/tools.md.

ToolWhat it returns
query_metricsAny metric over any period (sales, fees, profit, ads, sessions...), by SKU, ASIN, marketplace, account or time grain
find_moversBiggest gainers and losers for a metric versus a baseline period
query_pnl_bridgeOrder-based and cash-based P&L of the same months side by side, and what separates them
explain_movementCausal signals behind one product's movement: traffic, conversion, price, Buy Box, ads, rank
query_advertisingSponsored Products, Brands and Display, from campaign down to keyword and ASIN
query_search_termsCustomer search queries behind ad spend, for negatives and discovery
query_dspAmazon DSP spend and results by advertiser, order, line item, product, device, creative or audience
query_sqpSearch Query Performance: search volume, impression and purchase share by query, you versus the whole market
query_inventoryFBA and AWD stock, velocity, days of cover, stockout risk, reorder quantities
query_listing_healthSuppressed, not buyable, Buy Box lost, catalog issues
query_reviewsReviews, critical reviews and star rating per ASIN
query_subscribe_and_saveSubscribe & Save health, offers and eligibility
query_vendor_purchase_orders / query_vendor_inventory / query_vendor_invoices / query_vendor_remittancesVendor Central: Amazon's purchase orders, the stock Amazon holds, your invoices, Amazon's payments and deductions
get_listing_content / update_listing_contentRead and edit listing content on Amazon (title, bullets, backend keywords, attributes), previewed before it is confirmed
import_cogs / import_fbm_costs / import_vat_categoriesMaintain your cost inputs from the conversation, previewed before anything is saved

Example prompts

A longer library organised by job lives in prompts/ and at novadata.io/amazon-mcp-prompts.

Profit

  • Give me last week's P&L by marketplace and name the three biggest swings.
  • Which SKUs lost the most net profit versus last month, and why?
  • What is my true TACoS by ASIN this quarter?

Advertising

  • Which search terms spent the most last week without a sale?
  • Find SKUs where ad spend is up 30% but units are flat or down.
  • What did Amazon DSP cost us last month, and what did it drive?

Vendor Central

  • What did Amazon order from us this week versus last week?
  • Compare Vendor Central shipped revenue with Seller Central sales for the same products this month.

Inventory

  • Which SKUs will run out of stock in the next 30 days at current sales speed?
  • Which products should I reorder this week, given my lead times?

How it differs from Amazon's own MCP servers

Amazon is the source of truth for the data it serves, and its MCP servers are a good fit for what they cover: the Amazon Ads MCP server for campaign management, and Amazon's Selling Partner plugin for Seller Central (US stores at launch).

Nova adds the processing on top: reports pre-joined so one call returns a consistent answer, your own costs applied so the answer is profit rather than sales, ad and DSP spend inside the P&L, Vendor Central alongside Seller Central, and every account and marketplace in one question. Agencies and multi-brand teams query all their accounts at once.

More detail: novadata.io/amazon-seller-central-mcp-server

Security and permissions

  • OAuth against Nova. No Amazon password is ever shared with the MCP
  • Access is per Amazon account and revocable at any time from Nova
  • Workspace members only see the accounts they are assigned to
  • Cost tools write only to your own Nova configuration (COGS, FBM, VAT, tags, stock settings), never to Amazon, and always preview the change before saving it
  • Listing content edits (title, bullets, description, backend keywords, product attributes, never price or quantity) are available on Seller Central when enabled for your workspace, for the account owner only, previewed with Amazon's validation before they are confirmed
  • Campaign actions are in development and will follow the same preview and confirm pattern

Contributing

Issues and pull requests are welcome for the configs, docs and prompt library. For questions about the hosted service, contact Nova through the site.

License

MIT for the contents of this repository. See LICENSE. The Nova MCP service itself is commercial.

الأسئلة الشائعة

ما هو Nova Amazon MCP Server؟

Amazon Seller Central, Vendor Central and Ads data, profit-ready, for Claude, ChatGPT and any AI

كيف أثبّت Nova Amazon MCP Server؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http nova-amazon-mcp-server 'https://mcp.novadata.io/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Nova Amazon MCP Server إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Nova Amazon MCP Server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Nova Amazon MCP Server؟

ينشره nova-data-analytics. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.