The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Amz Vault listing page.
Connect Claude (or any MCP-capable AI client) directly to your Amazon Seller Central and Amazon Ads data - true profitability, PPC performance at every grain, inventory, forecasting, and safe, approval-gated changes.
https://www.amz-vault.com/mcp (Streamable HTTP)This repository is the public registry listing for the hosted AMZ Vault MCP server. The server itself runs at amz-vault.com - there is no code to install or run from here.
https://www.amz-vault.com/mcp.Want to try the tools before connecting your own account? The live demo runs on a synthetic seller account and needs no signup.
| Client | How |
|---|---|
| Claude (web / desktop) | Settings -> Connectors -> Add custom connector -> https://www.amz-vault.com/mcp |
| Claude Code | claude mcp add --transport http amz-vault https://www.amz-vault.com/mcp |
| Cursor | Settings -> MCP -> Add server -> type streamable-http, URL https://www.amz-vault.com/mcp |
| VS Code (Copilot) | MCP: Add Server from the command palette -> HTTP -> https://www.amz-vault.com/mcp |
| Windsurf | Add to mcp_config.json: {"mcpServers": {"amz-vault": {"serverUrl": "https://www.amz-vault.com/mcp"}}} |
| Anything else | Any client that speaks MCP Streamable HTTP + OAuth 2.1 works. Metadata is discoverable at /.well-known/oauth-protected-resource/mcp. |
On first use every client goes through the same OAuth sign-in and consent screen - approve it once per client and you're connected.
Generated from the live tool registry on 2026-09-05. The always-current reference, including full parameter documentation, lives at amz-vault.com/docs.
| Tool | What it does |
|---|---|
account_feedback | Feedback & support channel to the AMZ Vault team (NOT an Amazon write): action=submit opens a thread (subject, body, category bug|idea|qu... |
account_management_guide | The operator's brand & PPC decision framework: margin spine (PPD + margin bands), product postures, campaign structure/bidding, harvestin... |
account_profiles | List the advertising profiles (PPC accounts) bridged to this token's seller connections. |
account_report | THE canonical account overview — ONE call: period cards + settlement waterfall + freshness caveats for the money datasets, with quote_rules |
account_sellers | List the Amazon seller connections this token can access, with their marketplaces and currencies. |
account_support_access | Grant or revoke the AMZ Vault support team's READ-ONLY view of this account: action=grant lets support see what the user sees for 7 days... |
| Tool | What it does |
|---|---|
data_describe | Without arguments: list every warehouse dataset available to data_query |
data_freshness | Per-dataset sync freshness, row counts, date coverage and backfill progress — use to caveat answers correctly |
data_query | Generic query over any warehouse dataset (see data_describe): column projection, filters (eq/neq/gt/gte/lt/lte/in/contains), date bounds,... |
| Tool | What it does |
|---|---|
pnl_breakdown | Settlement-basis account waterfall: revenue → refunds → COGS → gross profit → Amazon fees → contribution margin → advertising → net profi... |
pnl_by_asin | Per-ASIN P&L rows for a date window (optionally one ASIN): sales, units, fees, COGS, margins, TACoS, stock. |
pnl_expenses | Custom operating expenses (subscriptions, VA, freight, 3PL…): scope, recurrence, amounts. |
pnl_mcf_summary | Multi-Channel Fulfillment (off-Amazon) totals: units, orders, fulfillment fees and COGS for a window. |
pnl_period_cards | The dashboard mini-P&L cards (Today / Yesterday / MTD / This-month forecast / Last month). |
pnl_refunds | Refund components for a window: net refund amount, count, and itemized lines (reimbursements, restocking). |
pnl_sb_attribution | Per-ASIN Sponsored Brands cost attribution (the sales-weighted split of campaign-level SB spend). |
pnl_settlement_audit | Settlement fee audit: every distinct fee combination Amazon charged, classified into P&L buckets — verify nothing is misclassified or mis... |
pnl_summary | Profit & Loss summary for a date window: account tiles (sales, fees, COGS, ad spend, gross profit, contribution margin, net profit, TACoS... |
| Tool | What it does |
|---|---|
inventory_health | FBA fulfillable/inbound/reserved units, aged inventory, restock recommendations and AWD pool per SKU |
product_cogs | Current per-SKU landed costs (COGS) and coverage summary. |
product_fee_preview | Amazon's own estimated fees per SKU for the coming weeks (referral, fulfillment, storage). |
product_library | The canonical product catalog with breakeven ACoS and effective BE margin targets per product family. |
| Tool | What it does |
|---|---|
brand_market_basket | What customers buy together with each ASIN (bought-with pairs and combination shares). |
brand_repeat_purchase | Customer loyalty per ASIN: repeat buyer share and repeat revenue by week. |
brand_search_catalog | Per-ASIN search funnel totals across ALL queries (query-less SQP): impressions, clicks, cart adds, purchases, median prices. |
brand_sqp | Search Query Performance: organic search funnel per (ASIN, query) — impressions/clicks/cart-adds/purchases with shares |
brand_top_search_terms | Marketplace-wide top search terms with the top-3 clicked ASINs and their click/conversion shares |
| Tool | What it does |
|---|---|
keyword_finder | Keyword Finder (reverse-ASIN / multi-input lookup): every keyword phrase the input ASINs are known for, merged from first-party data — SQ... |
| Tool | What it does |
|---|---|
ppc_account_summary | Get account-level aggregate metrics for a date range: total spend, sales, ACoS, ROAS, clicks, impressions, purchases. |
ppc_ad_groups | Query ad group performance data within campaigns |
ppc_ad_type_breakdown | Get performance comparison across ad types (SP vs SB vs SD) |
ppc_advertised_products | Query product/ASIN-level performance (SP+SD ad grain, merged per ASIN with a per-program split; SB per-ASIN spend exists only in the blen... |
ppc_asset_upload_link | Mint a 1-hour browser-upload link so the USER can hand over a local file (chat attachments cannot reach the server) |
ppc_bid_recommendations | Amazon's suggested bid + range per keyword for a SPECIFIC campaign (routed by campaign type) |
ppc_budget_alerts | Find campaigns approaching or exceeding their daily budget |
ppc_campaign_create_guide | The verified contract for creating campaigns via stage_campaign_create: per-format required fields, goals, landing-page rules, asset sour... |
ppc_campaign_details | Get detailed data for specific SP campaigns including placements, advertised ASINs, placement modifiers, and top keywords/targets |
ppc_campaign_metadata | Campaign configuration and user metadata: bidding strategy, placement settings, goal/KPI, tags, notes. |
ppc_campaign_search | Lightweight campaign name lookup |
ppc_campaigns | Query campaign performance data with optional filters |
ppc_change_history | Get recent campaign change history showing what changed, when, old values, and new values |
ppc_conversion_funnel | Get conversion funnel data: Impressions → Clicks → Orders with rates between each stage |
ppc_creatives | SB ad creatives at ad grain (headline, brand logo, custom images, video asset ids, ASINs, landing page, creative status) plus SD creative... |
ppc_daily_trend | Get day-by-day metrics for trend analysis |
ppc_dayparting_analytics | Get the dayparting (time-of-day bid modifier) schedule for the profile |
ppc_describe | Without arguments: catalog of the raw PPC datasets behind ppc_query (daily report tables at campaign/ad-group/target/search-term/placemen... |
ppc_harvesting_candidates | Find converting search terms eligible for promotion to manual campaigns |
ppc_keywords | Query keyword/target bid performance across Sponsored Products AND Sponsored Brands (rows carry ad_type SP/SB; SD targeting expressions l... |
ppc_match_type_breakdown | Get performance breakdown by keyword match type (Broad, Phrase, Exact, etc.) |
ppc_negation_candidates | Find non-converting search terms with significant spend — candidates for negative keyword addition |
ppc_negatives | Current negative keywords and negative product targets (campaign- and ad-group-level), with state and source. |
ppc_new_to_brand | New-to-brand purchases/sales and NTB% per campaign (SB + SD, from standard report columns — no AMC needed) |
ppc_optimization_suggestions | Analyze campaigns and categorize into top performers (at or below target ACoS), running hot (significantly over target), and wasted spend... |
ppc_period_comparison | Compare current period metrics to the previous period of equal length |
ppc_placement_modifiers | Current placement bid modifiers per campaign (top of search, product pages, rest of search). |
ppc_placements | Get performance breakdown by placement type (Top of Search, Product Pages, Rest of Search) from SP placement data |
ppc_portfolios | Get portfolio-level performance rollup |
ppc_product_family | Look up parent/child product hierarchy from the product library (Category Listing report) |
ppc_product_report | THE canonical product/family report — ONE call returning every view labeled: family resolution, asin_accurate ad totals (SP+SD ad grain —... |
ppc_query | FULL-fidelity row-level query over any raw PPC dataset (see ppc_describe): column projection, filters (eq/neq/gt/gte/lt/lte/in/contains),... |
ppc_search_terms | Query search term performance data |
| Tool | What it does |
|---|---|
automation_activity | THE approval inbox for V2 rule automation — the ONLY surface for pending automation approvals (MinMax/AOE/scheduled-task tools are separa... |
automation_aoe_status | Adaptive Optimization Engine: per-campaign configs, modes, guardrails, and recent optimization cycles |
automation_dayparting | Dayparting, READ-ONLY: action=list shows schedules + assignments (mutations live in stage_dayparting_schedule). |
automation_minmax_results | Recent MinMax budget-analysis runs: scope, top performers, campaigns running hot |
automation_recent_tasks | Get the list of scheduled automation tasks with their status, cadence, and last execution results. |
automation_rules | V2 rule-based automation, READ-ONLY: action=list|get|dry_run (mutations live in stage_automation_rule) |
automation_scheduled_tasks | Scheduled tasks: type, cadence, enabled state, last and next run times |
| Tool | What it does |
|---|---|
aplus_document | Fetch ONE A+ content document LIVE, including its full contentModuleList — the copy source for edits (the aplus_content dataset holds met... |
| Tool | What it does |
|---|---|
cancel_staged_changes | Cancel a pending proposal without executing it. |
confirm_staged_changes | EXECUTE a pending proposal — call ONLY after you have rendered the full diff to the user as text (entities by name, current → proposed, r... |
stage_ad_group_create | Create a new SP ad group in an existing campaign (name + default bid; created ENABLED) |
stage_ad_group_update | Rename an ad group (SP/SB) or change its default bid (SP only — SB ad groups have no default bid) |
stage_aplus_update | Create or update an A+ (EBC/Premium) content document, optionally attach ASINs and submit for Amazon approval |
stage_asset_upload | Upload an IMAGE or VIDEO into the Creative Asset Library — from a public source_url, or from a staged_file_id (browser upload via ppc_ass... |
stage_automation_review | Stage a decision on automation approval-inbox items (see automation_activity for the inbox itself): action=approve|reject|undo, each take... |
stage_automation_rule | Stage a rule mutation: action=create|update|delete|toggle|duplicate|assign|unassign|run_now |
stage_bid_changes | Propose bid changes on SP + SB + SD keywords/targets matching filters (ad_type narrows to one program) |
stage_budget_changes | Propose SP campaign daily-budget changes |
stage_campaign_create | Create Sponsored Products, Sponsored Brands or Sponsored Display campaigns end-to-end |
stage_campaign_tags | Tag/annotate a campaign in AMZ Vault (add_tags / remove_tags / note) — pure metadata, nothing is sent to Amazon |
stage_campaign_update | Update campaigns: name, budget_amount, budget_type (LIFETIME is SB-only), bidding_strategy, start_date / end_date (YYYY-MM-DD; null end_d... |
stage_cogs_update | Propose setting per-SKU landed costs (COGS), time-versioned |
stage_competitor_watchlist | Propose adding/removing competitor ASINs on the review-insights watchlist |
stage_dayparting_schedule | Stage a dayparting mutation: action=create|update|delete|toggle|clone|assign|unassign |
stage_entity_status | Pause/enable/archive specific entities BY ID: ad groups, product ads, keywords, targets, or campaigns (complements the filter-based stage... |
stage_listing_update | Update LIVE Amazon listing content: title, bullet_points (full replacement list), description, search_terms (backend keywords, ~249 bytes... |
stage_margin_target | Propose a manual BE (breakeven) margin target for a product family (null be_margin_pct clears it so the computed breakeven applies) |
stage_negatives | Propose adding negative keywords / negative ASIN targets |
stage_negatives_remove | REMOVE (archive) negative keywords / negative product targets by their local ids from ppc_negatives — the other half of negation management |
stage_po_upsert | Propose creating or updating purchase orders (matched by po_number per connection): supplier_name (created if new), status/milestone date... |
stage_portfolio_create | Create a new portfolio (no budget cap; set budgets after via stage_portfolio_update, incl |
stage_portfolio_update | Update a portfolio: name, budget_amount, budget_policy (DATE_RANGE/MONTHLY_RECURRING/"remove"), budget_start_date, budget_end_date |
stage_product_ad_add | Add advertised products to an existing SP or SD ad group (campaign_type, default SP) — created ENABLED |
stage_product_edit | Propose editing one Product Library field (locks it against future syncs) |
stage_status_change | Propose enabling/pausing campaigns matching filters |
stage_supplier_upsert | Propose creating or updating suppliers (matched by name per connection): contacts, payment terms, and the production/transit lead times t... |
stage_targeting_add | Add keywords, ASIN product targets, and/or category targets to an EXISTING campaign + ad group (SP or SB) — e.g |
staged_changes_pending | List this account's pending (unconfirmed) proposals. |
| Tool | What it does |
|---|---|
forecast_reorder_report | Reorder advisor for one seller connection: per-ASIN runout dates from the latest forecast (counting FBA + AWD + inbound + open purchase o... |
forecast_report | THE 12-month per-ASIN unit forecast (nightly engine): brand totals vs last year, seasonality index, diagnostics incl |
workforce_check_in | Check in with the AMZ Vault AI Workforce and receive the next worker packet |
workforce_report | Submit the results of a workforce packet |
workforce_status | Read-only view of the AI Workforce: hired roles, queue depth, staged changes awaiting dashboard approval, usage advisor, and recent runs |
npm install.account_feedback tool itself