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)

1. Create an AMZ Vault account at amz-vault.com and connect your Amazon account (14-day free trial, no card required).
2. In Claude: Settings -> Connectors -> Add custom connector, and paste https://www.amz-vault.com/mcp.
3. Claude opens the AMZ Vault sign-in and consent screen. Approve it.
4. 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