Amz Vault

io.github.TheBurdzPublished by GitHub account TheBurdzv1.0.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted MCP connector for Amazon Seller Central and Amazon Ads data: settlement-based P&L, PPC analytics, inventory and forecasting, with approval-gated writes.

What you can do
  • Read account overview, seller connections, advertising profiles and warehouse datasets, and run filtered queries over them
  • Analyze profitability: settlement-basis P&L waterfall, per-ASIN P&L, refunds, fee audits, operating expenses and MCF totals
  • Review PPC performance at campaign, ad group, keyword, search term, placement and product grain, plus bid recommendations, budget alerts and optimization suggestions
  • Explore brand analytics, search query performance, keyword research and competitor keyword gaps
  • Check inventory health, COGS, fee previews, reorder advice and 12-month per-ASIN forecasts
  • Stage changes such as bids, budgets, negatives, campaigns, listings, A+ content and automation…
When to use it
Useful for Amazon sellers and agencies who want an assistant to answer profitability, advertising and inventory questions from their own Seller Central and Ads data, and to prepare bid, budget or listing changes that a person reviews before anything is sent to Amazon.
Requirements
A remote Streamable HTTP endpoint; nothing to install locally. Requires an AMZ Vault account with a connected Amazon seller account and OAuth 2.1 sign-in with per-client consent. The connector is included with an AMZ Vault trial or subscription; a free demo on a synthetic account needs no signup.
Before you install
The connector reads live seller and advertising data through your authorized Amazon connection, so access scope matters. Staged writes can change bids, budgets, campaigns, listings, A+ content and automation rules once you confirm them, and destructive operations are separately flagged. Granting support access gives the vendor's team a read-only view for a limited period. Admin-only tools expose account health and operational events.

Installation

In SourceWeft

  1. Open Amz Vault in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.TheBurdz%2Famz-vault/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "amz-vault": {
      "type": "http",
      "url": "https://www.amz-vault.com/mcp"
    }
  }
}

README

AMZ Vault MCP

[AMZ Vault MCP server]

[AllMCPs Verified]

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)

  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

ClientHow
Claude (web / desktop)Settings -> Connectors -> Add custom connector -> https://www.amz-vault.com/mcp
Claude Codeclaude mcp add --transport http amz-vault https://www.amz-vault.com/mcp
CursorSettings -> 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
WindsurfAdd to mcp_config.json: {"mcpServers": {"amz-vault": {"serverUrl": "https://www.amz-vault.com/mcp"}}}
Anything elseAny 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

ToolWhat it does
account_feedbackFeedback & support channel to the AMZ Vault team (NOT an Amazon write): action=submit opens a thread (subject, body, category bug|idea|...
account_health_checkPer-connection onboarding + sync health across ALL tenants (SUPER-ADMIN ONLY)
account_helpSearch and read AMZ Vault's Help Center - the same articles users see at /help: setup, connections and data semantics, per-page platform...
account_management_guideThe operator's brand & PPC decision framework: margin spine (PPD + margin bands), product postures, campaign structure/bidding, harvestin...
account_notice_draftQueue a one-off notice email to a user for admin review (ADMIN-ONLY)
account_ops_eventsOperational health feed (ADMIN-ONLY): deduped errors / warnings / API-throttle events from the worker and web services with occurrence co...
account_profilesList the advertising profiles (PPC accounts) bridged to this token's seller connections.
account_reportTHE canonical account overview — ONE call: period cards + settlement waterfall + freshness caveats for the money datasets, with quote_rules
account_sellersList the Amazon seller connections this token can access, with their marketplaces and currencies.
account_support_accessGrant 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

ToolWhat it does
data_describeWithout arguments: list every warehouse dataset available to data_query
data_freshnessPer-dataset sync freshness, row counts, date coverage and backfill progress — use to caveat answers correctly
data_queryGeneric query over any warehouse dataset (see data_describe): column projection, filters (eq/neq/gt/gte/lt/lte/in/contains), date bounds,...

P&L / profitability

ToolWhat it does
pnl_breakdownSettlement-basis account waterfall: revenue → refunds → COGS → gross profit → Amazon fees → contribution margin → advertising → net profi...
pnl_by_asinPer-ASIN P&L rows for a date window (optionally one ASIN): sales, units, fees, COGS, margins, TACoS, stock.
pnl_expensesCustom operating expenses (subscriptions, VA, freight, 3PL…): scope, recurrence, amounts.
pnl_mcf_summaryMulti-Channel Fulfillment (off-Amazon) totals: units, orders, fulfillment fees and COGS for a window.
pnl_period_cardsThe dashboard mini-P&L cards (Today / Yesterday / MTD / This-month forecast / Last month).
pnl_refundsRefund components for a window: net refund amount, count, and itemized lines (reimbursements, restocking).
pnl_sb_attributionPer-ASIN Sponsored Brands cost attribution (the sales-weighted split of campaign-level SB spend).
pnl_settlement_auditSettlement fee audit: every distinct fee combination Amazon charged, classified into P&L buckets — verify nothing is misclassified or mis...
pnl_summaryProfit & Loss summary for a date window: account tiles (sales, fees, COGS, ad spend, gross profit, contribution margin, net profit, TACoS...

Products & inventory

ToolWhat it does
inventory_healthFBA fulfillable/inbound/reserved units, aged inventory, restock recommendations and AWD pool per SKU
inventory_shipment_trackingLive supply-chain tracking (SP-API Tracking, US store only): milestones and estimates for a shipment moving through Amazon - pass ONE ide...
product_cogsCurrent per-SKU landed costs (COGS) and coverage summary.
product_fee_previewAmazon's own estimated fees per SKU for the coming weeks (referral, fulfillment, storage).
product_libraryThe canonical product catalog with breakeven ACoS and effective BE margin targets per product family.

Brand analytics

ToolWhat it does
brand_market_basketWhat customers buy together with each ASIN (bought-with pairs and combination shares).
brand_repeat_purchaseCustomer loyalty per ASIN: repeat buyer share and repeat revenue by week.
brand_search_catalogPer-ASIN search funnel totals across ALL queries (query-less SQP): impressions, clicks, cart adds, purchases, median prices.
brand_sqpSearch Query Performance: organic search funnel per (ASIN, query) — impressions/clicks/cart-adds/purchases with shares
brand_store_analyticsBrand Store performance (Stores Analytics API): view='insights' = store traffic/sales by DATE / PAGE / SOURCE / STORE / TAG (visits, visi...
brand_top_search_termsMarketplace-wide top search terms with the top-3 clicked ASINs and their click/conversion shares

Keyword intelligence

ToolWhat it does
keyword_finderKeyword Finder (reverse-ASIN / multi-input lookup): every keyword phrase the input ASINs are known for, merged from first-party data — SQ...
keyword_opportunitiesKW research FRONT DOOR - start here for any keyword question about a product (new or established)
keyword_researchKeyword Research (marketplace term universe): search the FULL Top Search Terms store by phrase - not anchored to any ASIN

PPC — read

ToolWhat it does
ppc_account_summaryGet account-level aggregate metrics for a date range: total spend, sales, ACoS, ROAS, clicks, impressions, purchases.
ppc_ad_groupsQuery ad group performance data within campaigns
ppc_ad_type_breakdownGet performance comparison across ad types (SP vs SB vs SD)
ppc_advertised_productsQuery 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_linkMint a 1-hour browser-upload link so the USER can hand over a local file (chat attachments cannot reach the server)
ppc_bid_recommendationsAmazon's suggested bid + range per keyword for a SPECIFIC campaign (routed by campaign type)
ppc_budget_alertsFind campaigns approaching or exceeding their daily budget - SAME-DAY where Marketing Stream data flows (signal_source=stream rows are mi...
ppc_campaign_create_guideThe verified contract for creating campaigns via stage_campaign_create: per-format required fields, goals, landing-page rules, asset sour...
ppc_campaign_detailsGet detailed data for specific SP campaigns including placements, advertised ASINs, placement modifiers, and top keywords/targets
ppc_campaign_metadataCampaign configuration and user metadata: bidding strategy, placement settings, goal/KPI, tags, notes.
ppc_campaign_searchLightweight campaign name lookup
ppc_campaignsQuery campaign performance data with optional filters
ppc_change_historyGet recent campaign change history showing what changed, when, old values, and new values
ppc_conversion_funnelGet conversion funnel data: Impressions → Clicks → Orders with rates between each stage
ppc_creativesSB ad creatives at ad grain (headline, brand logo, custom images, video asset ids, ASINs, landing page, creative status) plus SD creative...
ppc_daily_trendGet day-by-day metrics for trend analysis
ppc_dayparting_analyticsDayparting schedule AND real hour-of-day performance
ppc_describeWithout arguments: catalog of the raw PPC datasets behind ppc_query (daily report tables at campaign/ad-group/target/search-term/placemen...
ppc_harvesting_candidatesFind converting search terms eligible for promotion to manual campaigns
ppc_keywordsQuery keyword/target bid performance across Sponsored Products AND Sponsored Brands (rows carry ad_type SP/SB; SD targeting expressions l...
ppc_match_type_breakdownGet performance breakdown by keyword match type (Broad, Phrase, Exact, etc.)
ppc_negation_candidatesFind non-converting search terms with significant spend — candidates for negative keyword addition
ppc_negativesCurrent negative keywords and negative product targets (campaign- and ad-group-level), with state and source
ppc_new_to_brandNew-to-brand purchases/sales and NTB% per campaign (SB + SD, from standard report columns — no AMC needed)
ppc_optimization_suggestionsAnalyze campaigns and categorize into top performers (at or below target ACoS), running hot (significantly over target), and wasted spend...
ppc_period_comparisonCompare current period metrics to the previous period of equal length
ppc_placement_modifiersCurrent placement bid modifiers per campaign (top of search, product pages, rest of search).
ppc_placementsGet performance breakdown by placement type (Top of Search, Product Pages, Rest of Search) from SP placement data
ppc_portfoliosGet portfolio-level performance rollup
ppc_product_familyLook up parent/child product hierarchy from the product library (Category Listing report)
ppc_product_reportTHE canonical product/family report — ONE call returning every view labeled: family resolution, asin_accurate ad totals (SP+SD ad grain —...
ppc_queryFULL-fidelity row-level query over any raw PPC dataset (see ppc_describe): column projection, filters (eq/neq/gt/gte/lt/lte/in/contains),...
ppc_recommendationsAmazon's own consolidated recommendations (unified Recommendations API): bid/budget/bidding-strategy changes, new keywords, negatives, ta...
ppc_search_termsQuery search term performance data

Automation

ToolWhat it does
automation_activityTHE approval inbox for V2 rule automation — the ONLY surface for pending automation approvals (MinMax/AOE/scheduled-task tools are separa...
automation_aoe_statusAdaptive Optimization Engine: per-campaign configs, modes, guardrails, and recent optimization cycles
automation_daypartingDayparting, READ-ONLY: action=list shows schedules + assignments (mutations live in stage_dayparting_schedule).
automation_minmax_resultsRecent MinMax budget-analysis runs: scope, top performers, campaigns running hot
automation_recent_tasksGet the list of scheduled automation tasks with their status, cadence, and last execution results.
automation_rulesV2 rule-based automation, READ-ONLY: action=list|get|dry_run (mutations live in stage_automation_rule)
automation_scheduled_tasksScheduled tasks: type, cadence, enabled state, last and next run times

A+ content

ToolWhat it does
aplus_documentFetch 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)

ToolWhat it does
cancel_staged_changesCancel a pending proposal without executing it.
confirm_staged_changesEXECUTE 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_createCreate a new SP ad group in an existing campaign (name + default bid; created ENABLED)
stage_ad_group_updateRename an ad group (SP/SB) or change its default bid (SP only — SB ad groups have no default bid)
stage_aplus_updateCreate or update an A+ (EBC/Premium) content document, optionally attach ASINs and submit for Amazon approval
stage_asset_uploadUpload 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_reviewStage a decision on automation approval-inbox items (see automation_activity for the inbox itself): action=approve|reject|undo, each ta...
stage_automation_ruleStage a rule mutation: action=create|update|delete|toggle|duplicate|assign|unassign|run_now
stage_bid_changesPropose bid changes on SP + SB + SD keywords/targets matching filters (ad_type narrows to one program)
stage_budget_changesPropose SP campaign daily-budget changes
stage_campaign_createCreate Sponsored Products, Sponsored Brands or Sponsored Display campaigns end-to-end
stage_campaign_tagsTag/annotate a campaign in AMZ Vault (add_tags / remove_tags / note) — pure metadata, nothing is sent to Amazon
stage_campaign_updateUpdate campaigns: name, budget_amount, budget_type (LIFETIME is SB-only), bidding_strategy, start_date / end_date (YYYY-MM-DD; null end_d...
stage_cogs_updatePropose setting per-SKU landed costs (COGS), time-versioned
stage_competitor_watchlistPropose adding/removing competitor ASINs on the review-insights watchlist
stage_dayparting_scheduleStage a dayparting mutation: action=create|update|delete|toggle|clone|assign|unassign
stage_entity_statusPause/enable/archive specific entities BY ID: ad groups, product ads, keywords, targets, or campaigns (complements the filter-based stage...
stage_listing_updateUpdate LIVE Amazon listing content: title, bullet_points (full replacement list), description, search_terms (backend keywords, ~249 bytes...
stage_margin_targetPropose a manual BE (breakeven) margin target for a product family (null be_margin_pct clears it so the computed breakeven applies)
stage_negativesPropose adding negative keywords / negative ASIN targets
stage_negatives_removeREMOVE (archive) negative keywords / negative product targets by their local ids from ppc_negatives — the other half of negation management
stage_po_upsertPropose creating or updating purchase orders (matched by po_number per connection): supplier_name (created if new), status/milestone date...
stage_portfolio_createCreate a new portfolio (no budget cap; set budgets after via stage_portfolio_update, incl
stage_portfolio_updateUpdate a portfolio: name, budget_amount, budget_policy (DATE_RANGE/MONTHLY_RECURRING/"remove"), budget_start_date, budget_end_date
stage_product_ad_addAdd advertised products to an existing SP or SD ad group (campaign_type, default SP) — created ENABLED
stage_product_editPropose editing one Product Library field (locks it against future syncs)
stage_status_changePropose enabling/pausing campaigns matching filters
stage_supplier_upsertPropose creating or updating suppliers (matched by name per connection): contacts, payment terms, and the production/transit lead times t...
stage_targeting_addAdd keywords, ASIN product targets, and/or category targets to an EXISTING campaign + ad group (SP or SB) — e.g
staged_changes_pendingList this account's pending (unconfirmed) proposals

Other

ToolWhat it does
forecast_reorder_reportReorder advisor for one seller connection: per-ASIN runout dates from the latest forecast (counting FBA + AWD + inbound + open purchase o...
forecast_reportTHE 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

Links

Source: README.md at commit 84ae129

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts