How do I install Amz Vault?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Amz Vault need an API key?

No required environment variable is listed on this record.

What transport does Amz Vault use?

Amz Vault is reached over HTTP.

When was Amz Vault last checked?

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

Amz Vault MCP server

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...

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

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

Amz Vault

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions