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 分