AMZ Vault
Amazon Seller Central + Ads: settlement-accurate P&L, full PPC, every write staged for approval.
GitHub
1
ลองใช้ MCP นี้ผู้สนับสนุนเอกสาร
AMZ Vault MCP
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.
- Endpoint:
https://www.amz-vault.com/mcp(Streamable HTTP) - Auth: OAuth 2.1 with dynamic client registration - sign in with your AMZ Vault account when your AI client asks. No API keys to create, copy, or leak.
- Writes: every change is STAGED. Nothing reaches Amazon until you review the diff and confirm it.
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.
Quick start (Claude)
- Create an AMZ Vault account at amz-vault.com and connect your Amazon account (14-day free trial, no card required).
- In Claude: Settings -> Connectors -> Add custom connector, and paste
https://www.amz-vault.com/mcp. - Claude opens the AMZ Vault sign-in and consent screen. Approve it.
- Ask away: "How profitable was my account last month, after every fee?"
Want to try the tools before connecting your own account? The live demo runs on a synthetic seller account and needs no signup.
What makes it different
- Settlement-basis profit, not dashboard estimates. The P&L tools reconcile orders, refunds, every Amazon fee class, COGS, and your operating expenses against actual settlement data - the number your bank account agrees with.
- Answers at the right grain. Product questions get product-grain answers, campaign questions get campaign-grain answers, and every response is labeled with its scope so shared-campaign spend never gets double-counted.
- Staged writes with human approval. Bid changes, negatives, budgets, campaign creation, listing edits - the AI proposes, you see the exact diff, and only your confirmation executes it. There is no autonomous-write mode.
- The whole account, not just ads. PPC, organic search performance (SQP), Brand Analytics, inventory and restock, MCF, A+ content, per-ASIN forecasting, and reorder planning in one connector.
Example prompts
- "Which products lost money last month after all fees and ad spend?"
- "Find search terms bleeding spend with no orders and stage negatives for my approval."
- "Compare my SP vs SB vs SD performance this quarter."
- "Which keywords is my top competitor's ASIN ranking for that I'm not bidding on?"
- "When do I need to reorder each SKU, given current velocity and lead times?"
- "Stage a 15% bid reduction on every target above 60% ACoS in the last 30 days - show me the list first."
Client setup
| 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.
Tool catalog
Generated from the live tool registry on 2026-09-05. The always-current reference, including full parameter documentation, lives at amz-vault.com/docs.
Account & discovery
| 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... |
Data warehouse
| 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,... |
P&L / profitability
| 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... |
Products & inventory
| 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. |
Brand analytics
| 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 |
Keyword intelligence
| 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... |
PPC — read
| 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 |
Automation
| 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 |
A+ content
| 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... |
Staged writes (nothing reaches Amazon until you confirm)
| 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. |
Other
| 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 |
What this is NOT
- Not an autopilot. No write reaches Amazon without your explicit confirmation of the staged diff, ever.
- Not a scraper. All data comes from Amazon's official Selling Partner API and Amazon Ads API through your own authorized connection.
- Not a local server. The MCP server is hosted; this repository exists so registries and directories can list it. There is nothing to
npm install. - Not free-forever. The connector comes with every AMZ Vault trial and subscription. The live demo is free and needs no signup.
Security and privacy
- OAuth 2.1 with dynamic client registration and per-client consent; revoke any client's token at any time from Settings.
- Team members connect with their own accounts and see exactly what their access grants allow - grants resolve live on every call.
- Destructive operations are separately flagged, and the two that exist require the same explicit confirmation as everything else.
- Amazon's March 2026 Agent Policy, and how AMZ Vault complies with it: amz-vault.com/blog/amazon-ai-agent-policy
Links
- Website: amz-vault.com
- Live demo (no signup): amz-vault.com/demo
- Tool documentation: amz-vault.com/docs
- Free Claude skills built on this connector: amz-vault.com/skills
- Support: amz-vault.com -> Feedback & Support, or the
account_feedbacktool itself