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.

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

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

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

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.

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

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

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

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

ppc_daily_trend

Get day-by-day metrics for trend analysis

ppc_dayparting_analytics

Get the dayparting (time-of-day bid modifier) schedule for the profile

ppc_describe

Without arguments: catalog of the raw PPC datasets behind ppc_query (daily report tables at campaign/ad-group/target/search-term/placemen...

ppc_harvesting_candidates

Find converting search terms eligible for promotion to manual campaigns

ppc_keywords

Query keyword/target bid performance across Sponsored Products AND Sponsored Brands (rows carry ad_type SP/SB; SD targeting expressions l...

ppc_match_type_breakdown

Get performance breakdown by keyword match type (Broad, Phrase, Exact, etc.)

ppc_negation_candidates

Find non-converting search terms with significant spend — candidates for negative keyword addition

ppc_negatives

Current negative keywords and negative product targets (campaign- and ad-group-level), with state and source.

ppc_new_to_brand

New-to-brand purchases/sales and NTB% per campaign (SB + SD, from standard report columns — no AMC needed)

ppc_optimization_suggestions

Analyze campaigns and categorize into top performers (at or below target ACoS), running hot (significantly over target), and wasted spend...

ppc_period_comparison

Compare current period metrics to the previous period of equal length

ppc_placement_modifiers

Current placement bid modifiers per campaign (top of search, product pages, rest of search).

ppc_placements

Get performance breakdown by placement type (Top of Search, Product Pages, Rest of Search) from SP placement data

ppc_portfolios

Get portfolio-level performance rollup

ppc_product_family

Look up parent/child product hierarchy from the product library (Category Listing report)

ppc_product_report

THE canonical product/family report — ONE call returning every view labeled: family resolution, asin_accurate ad totals (SP+SD ad grain —...

ppc_query

FULL-fidelity row-level query over any raw PPC dataset (see ppc_describe): column projection, filters (eq/neq/gt/gte/lt/lte/in/contains),...

ppc_search_terms

Query search term performance data

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

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

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

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

stage_dayparting_schedule

Stage a dayparting mutation: action=create|update|delete|toggle|clone|assign|unassign

stage_entity_status

Pause/enable/archive specific entities BY ID: ad groups, product ads, keywords, targets, or campaigns (complements the filter-based stage...

stage_listing_update

Update LIVE Amazon listing content: title, bullet_points (full replacement list), description, search_terms (backend keywords, ~249 bytes...

stage_margin_target

Propose a manual BE (breakeven) margin target for a product family (null be_margin_pct clears it so the computed breakeven applies)

stage_negatives

Propose adding negative keywords / negative ASIN targets

stage_negatives_remove

REMOVE (archive) negative keywords / negative product targets by their local ids from ppc_negatives — the other half of negation management

stage_po_upsert

Propose creating or updating purchase orders (matched by po_number per connection): supplier_name (created if new), status/milestone date...

stage_portfolio_create

Create a new portfolio (no budget cap; set budgets after via stage_portfolio_update, incl

stage_portfolio_update

Update a portfolio: name, budget_amount, budget_policy (DATE_RANGE/MONTHLY_RECURRING/"remove"), budget_start_date, budget_end_date

stage_product_ad_add

Add advertised products to an existing SP or SD ad group (campaign_type, default SP) — created ENABLED

stage_product_edit

Propose editing one Product Library field (locks it against future syncs)

stage_status_change

Propose enabling/pausing campaigns matching filters

stage_supplier_upsert

Propose creating or updating suppliers (matched by name per connection): contacts, payment terms, and the production/transit lead times t...

stage_targeting_add

Add keywords, ASIN product targets, and/or category targets to an EXISTING campaign + ad group (SP or SB) — e.g

staged_changes_pending

List this account's pending (unconfirmed) proposals.

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

workforce_check_in

Check in with the AMZ Vault AI Workforce and receive the next worker packet

workforce_report

Submit the results of a workforce packet

workforce_status

Read-only view of the AI Workforce: hired roles, queue depth, staged changes awaiting dashboard approval, usage advisor, and recent runs