io.github.TheBurdz/amz-vault

OfficialLive

by TheBurdz

Amazon Seller Central + Ads: settlement-accurate P&L, full PPC, every write staged for approval.

AMZ Vault MCP Server (io.github.TheBurdz/amz-vault)

This Model Context Protocol (MCP) server connects an MCP-capable AI client to Amazon Seller Central and Amazon Ads data. It provides settlement-accurate P&L, full PPC data, and supports inventory, forecasting, and approval-gated updates. The public registry describes the server endpoint, authentication approach, and write workflow.

🛠️ Key Features

Amazon Seller Central + Amazon Ads integration
Settlement-accurate P&L
Full PPC performance “at every grain”
Inventory and forecasting data access
Writes are staged for review before confirmation

🚀 Use Cases

Analyze true profitability using settlement-accurate P&L
Evaluate PPC performance at detailed granularity
Plan inventory and forecasting with Amazon data
Apply Amazon changes only after reviewing diffs

⚡ Developer Benefits

MCP endpoint: https://www.amz-vault.com/mcp (Streamable HTTP)
OAuth 2.1 with dynamic client registration
Sign in with an AMZ Vault account when the client requests access
Avoids creating/copying/leaking API keys for this integration

⚠️ Limitations

Write operations require explicit user review and confirmation of staged diffs before reaching Amazon

🧾 Metadata (from public registry)

Slug: io-github-theburdz-amz-vault
Topics: amazon, amazon-ads, amazon-ppc, amazon-seller, claude, mcp, mcp-server, model-context-protocol

Topics

amazonamazon-adsamazon-ppcamazon-sellerclaudemcpmcp-servermodel-context-protocol

README.md21 KBView on GitHub

AMZ Vault MCP

Also published on the official MCP Registry as io.github.TheBurdz/amz-vault, and listed in Claude's connector directory, Smithery, and mcpservers.org.

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-22 - 110 tools (4 additional AI Workforce tools appear once a client is connected). 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\|...
`account_health_check`	Per-connection onboarding + sync health across ALL tenants (SUPER-ADMIN ONLY)
`account_help`	Search and read AMZ Vault's Help Center - the same articles users see at /help: setup, connections and data semantics, per-page platform...
`account_management_guide`	The operator's brand & PPC decision framework: margin spine (PPD + margin bands), product postures, campaign structure/bidding, harvestin...
`account_notice_draft`	Queue a one-off notice email to a user for admin review (ADMIN-ONLY)
`account_ops_events`	Operational health feed (ADMIN-ONLY): deduped errors / warnings / API-throttle events from the worker and web services with occurrence co...
`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
`inventory_shipment_tracking`	Live supply-chain tracking (SP-API Tracking, US store only): milestones and estimates for a shipment moving through Amazon - pass ONE ide...
`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_store_analytics`	Brand Store performance (Stores Analytics API): view='insights' = store traffic/sales by DATE / PAGE / SOURCE / STORE / TAG (visits, visi...
`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...
`keyword_opportunities`	KW research FRONT DOOR - start here for any keyword question about a product (new or established)
`keyword_research`	Keyword Research (marketplace term universe): search the FULL Top Search Terms store by phrase - not anchored to any ASIN

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 - SAME-DAY where Marketing Stream data flows (signal_source=stream rows are mi...
`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`	Dayparting schedule AND real hour-of-day performance
`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_recommendations`	Amazon's own consolidated recommendations (unified Recommendations API): bid/budget/bidding-strategy changes, new keywords, negatives, ta...
`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 ta...
`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

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

Install

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://www.amz-vault.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "amz-vault": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.amz-vault.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.