Amz Vault

io.github.TheBurdz由 GitHub 帳號 TheBurdz 發布v1.0.0更新於 Oct 24, 2026

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

已驗證Streamable HTTP可網頁執行金融資料與分析商業與電商

概覽

AI 產生的概覽

面向 Amazon Seller Central 與 Amazon Ads 的託管 MCP 連接器，提供以結算資料為基礎的利潤分析、PPC 分析、庫存與預測，寫入須經人工確認。

可以做什麼
  • 讀取帳戶總覽、賣家連線、廣告帳戶與資料倉儲資料集，並對其執行帶篩選條件的查詢
  • 分析獲利：以結算為基礎的 P&L 瀑布、依 ASIN 的 P&L、退款、費用稽核、營運支出與 MCF 彙總
  • 依廣告活動、廣告群組、關鍵字、搜尋詞、版位與商品粒度檢視 PPC 成效，並取得出價建議、預算警示與最佳化建議
  • 檢視品牌分析、搜尋查詢成效、關鍵字研究與競品關鍵字缺口
  • 檢查庫存健康、COGS、費用預估、補貨建議與依 ASIN 的 12 個月預測
  • 暫存出價、預算、否定關鍵字、廣告活動、Listing、A+ 內容與自動化規則等變更，並列出、確認或取消待處理提案
適用情境
適合亞馬遜賣家與代理商讓助理依自身 Seller Central 與廣告資料回答獲利、廣告與庫存問題，並準備出價、預算或 Listing 變更，由人工審核後再送出至亞馬遜。
執行需求
遠端 Streamable HTTP 端點，無需在本機安裝。需要 AMZ Vault 帳戶並已連結亞馬遜賣家帳戶，透過 OAuth 2.1 登入並逐一用戶端授權。連接器包含在 AMZ Vault 試用或訂閱中；以合成帳戶運作的免費示範無需註冊。
安裝前請注意
連接器會透過你授權的亞馬遜連線讀取即時賣家與廣告資料，須留意授權範圍。確認後暫存寫入可變更出價、預算、廣告活動、Listing、A+ 內容與自動化規則，破壞性操作會另行標示。授予支援存取會讓廠商團隊在有限期間內取得唯讀檢視。僅限管理員的工具會揭露帳戶健康與維運事件。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Amz Vault，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.TheBurdz%2Famz-vault/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "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

來源：README.md，提交 84ae129

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分