Setup in 3 Steps

Your First Requests

Try any of these prompts to see SellerSheet in action:

How It Works Behind the Scenes

Before You Connect

1. Create a free account at sellersheetai.com/dashboard
2. Connect at least one Amazon Seller Central or Vendor Central store via Amazon's OAuth flow
3. Open Google Sheets → Extensions → SellerSheet → Open Sidebar once to initialize your workspace (creates the Drive folder structure the MCP server reads and writes into)

Fastest path: install the SellerSheet plugin

On Claude Code and Codex, one plugin install gives you everything at once: the MCP server registers automatically (browser OAuth, no API key to paste) plus nine production skills that teach your agent SellerSheet's best practices — sheet building, operator dashboards, report querying, listing images, Amazon Ads, Data Kiosk, and noon reports.

# Claude Code
/plugin marketplace add sellersheetai/sellersheet-skills
/plugin install sellersheet-skills@sellersheet-marketplace

Then run /mcp, pick sellersheet, and sign in via the browser. Codex CLI reads the same marketplace format:

# Codex CLI
codex plugin marketplace add sellersheetai/sellersheet-skills
codex plugin add sellersheet-skills@sellersheet-marketplace
codex mcp login sellersheet

The skill bundle also works on OpenClaw, Antigravity, Gemini CLI, and any agent that scans a skill directory — install details and per-skill docs at github.com/sellersheetai/sellersheet-skills. Using a client without a plugin system? The manual configs below connect the same MCP server.

Quick Connect

In a hurry? Drop your key into this JSON block — it works as-is in Cursor, Cline, OpenClaw, and anything using the standard mcpServers shape:

{
  "mcpServers": {
    "sellersheet": {
      "type": "http",
      "url": "https://sellersheetai.com/mcp",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Get your key from the dashboard (SellerSheet MCP → Create Key). Prefer not to paste a key? Claude.ai and Claude Desktop support browser OAuth — see their tabs.

Pick Your AI Client

A few clients differ from the Quick Connect block above — Windsurf & Antigravity use serverUrl, VS Code nests under chat.mcp.servers, Codex uses TOML. Pick yours for the exact config.

claude mcp add --transport http --scope user sellersheet https://sellersheetai.com/mcp

{
  "mcpServers": {
    "sellersheet": {
      "type": "http",
      "url": "https://sellersheetai.com/mcp",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

{
  "mcpServers": {
    "sellersheet": {
      "url": "https://sellersheetai.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "sellersheet": {
      "serverUrl": "https://sellersheetai.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "sellersheet": {
      "serverUrl": "https://sellersheetai.com/mcp"
    }
  }
}

gemini mcp add --transport http --scope user sellersheet https://sellersheetai.com/mcp

{
  "servers": {
    "sellersheet": {
      "type": "http",
      "url": "https://sellersheetai.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "sellersheet": {
      "type": "streamableHttp",
      "url": "https://sellersheetai.com/mcp"
    }
  }
}

curl -sS https://sellersheetai.com/mcp \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Verify the Connection

After installing, always start your first session with get_user_context. It returns your plan, stores, workspace folder IDs, and permissions — every other tool depends on it.

Troubleshooting

Create a key and set its scope

How your AI knows its own limits

Every session should start with get_user_context — the response includes api_key_name and scope_source, so the AI knows which key is acting and what that key may do, and can tell you before attempting a write that would 403.

Store references

A store reference always names the marketplace: MYSTORE-AE, MYBRAND-US — never a bare store name. Bare names are rejected, and the error lists every ref that would have worked so the AI can self-correct in one step.

Paused stores

If every marketplace of a store is inactive on your plan, report syncing stops and the store is refused rather than answered from frozen data. get_user_context marks it sync_status: "paused" with a paused_reason. Remedies: upgrade the plan, or free a marketplace slot under My Stores → Edit Marketplaces. A partially active store (one marketplace paid, others not) still syncs its active marketplaces and is not paused.

Shared stores

Stores shared with you by another account (dashboard → My Stores → Share) carry their own per-user SP/Ads grant, set by the owner. Your effective access is the lower of the share grant and the acting key's scope.

Error decoder

What each account type unlocks

Common connection issues

What You Can Do

• Search your catalog by keyword, ASIN, SKU, or status
• Check listing health — find suppressed, incomplete, or errored listings
• View detailed attributes for any product (title, bullets, images, pricing)
• Pull your whole catalog into a Google Sheet — search_listings_items pages through every SKU and the AI writes them out for bulk review
• Look up catalog data for any ASIN on Amazon (even competitors)

Tutorial: Find Listings with Issues

Available Tools

Available Tools

Just Ask

Available Tools (9)

In your daily workflow

• Morning check — "any unshipped orders?" search_orders filters by status and date, so you triage pending, unshipped, or cancelled orders in one ask.
• A buyer writes in — paste the order ID. get_order returns the full picture for that one order: status, items, shipping service, tracking — everything you need to answer the message.
• "How did last month do?" — that's not an Orders-API question. Your orders sync into the warehouse continuously; query_report_data answers revenue, units, repeat-buyer questions over any date range instantly (see Synced Reports).
• "Where's the money for this order?" — get_financial_events_for_order itemizes the charges, fees, and refunds behind a single order (see Financial Reports).

Available Tools

Available Tools

Available Tools

In your daily workflow

• Before creating a shipment — get_inventory_summaries returns Amazon's live numbers for the SKUs you're about to send: fulfillable, inbound, reserved, unsellable. Use it when the decision depends on right now.
• Restock day — "which SKUs run out within 3 weeks?" That's an analysis over your synced FBA reports (inventory ledger, restock recommendations, aging) via query_report_data — instant, covers every SKU, and joins with your sales velocity.
• Stranded & aging audit — the synced stranded-inventory and aging tables surface cash quietly stuck in fulfillment centers; ask for them monthly.

Available Tools

The shipment day, step by step

Available Tools

The compound tools above orchestrate these granular operations. Your AI picks the right ones; you only need the table when you want fine control over a single step — most generate/list pairs are async: generate starts the job on Amazon, list reads the result.

What You Can Do

• Preview before committing — get delivery speed options and fulfillment fees for a hypothetical order
• Create fulfillment orders — Amazon picks, packs and ships from your FBA stock
• Track every package — carrier, tracking numbers, delivery estimates
• Handle changes — update, cancel, or create a return for an existing fulfillment order

Available Tools

What You Can Do

• Create campaigns with automatic or manual targeting
• Manage ad groups, keywords, and product targets
• Get bid recommendations from Amazon's algorithm
• Add negative keywords to reduce wasted spend
• Bulk create complete campaign structures in one request
• Export campaign data for analysis
• View change history for the last 90 days

Tutorial: Launch a New Campaign

Available Tools (19)

Available Tools (9)

Available Tools (8)

Available Tools

Available Tools (10)

How It Works

Tutorial: Query Your Sales Data

Available Report Types

Available Tools

Available Tools

Available Tools (5)

Available Tools (3)

Available Tools

Available Tools

In your daily workflow

• Before writing anything — "does this ASIN already have A+?" search_content_publish_records answers per ASIN, so you never draft content that would fight an existing live document.
• Launch day — create_and_publish_aplus is the one-call pipeline: uploads your images, creates the document, links the ASINs, and submits for Amazon review. One prompt, whole module set.
• Iterating on a draft — update_content_document edits copy and modules while the document is still DRAFT; post_content_document_approval_submission sends it for review when you're happy.
• Managing a family — new variation added? validate_content_document_asin_relations checks the ASINs first (read-only), then post_content_document_asin_relations replaces the linked set.
• Portfolio review — list_aplus_sheet_rows pulls up to 50 documents with full detail into your Google Sheet, so you can audit coverage brand-wide.
• Take it down without losing it — post_content_document_suspend_submission unpublishes while keeping the document for later.

Available Tools

Available Tools (9)

How it works

• Generate or edit — describe the image (or supply reference images to edit); jobs run async, poll with check_image_job
• CDN delivery — finished images return a cdn_url on cdn.sellersheetai.com; nothing is written to Google Drive
• Library & versions — images are keyed by store + parent SKU + child SKU + slot, with automatic version numbers; browse and manage everything at /studio/library
• Studio — for interactive drafting, Studio stages generations per job and lets you confirm the winner into the library

Billing

Image generation is billed from prepaid credits at $0.20 per delivered image (minimum top-up $20 at /billing). Failed jobs are not charged. Your store ref is validated before any credit is deducted.

Available Tools

Catalog & Content

Create and update products (single or batch), manage content, map barcodes to SKUs, and run bulk imports/exports through signed URLs. Drafts and live listings both load into your Google Sheet for review before publishing.

Pricing, Stock & Offers

Batch-read and batch-update prices (including transfer prices for FBN), update stock levels, and inspect live product offers.

Inbound & Operations

The full FBN inbound flow — eligible items, shipment creation, slot scheduling, item updates and status transitions — plus warehouses, return references and cross-border helpers.

Synced noon Reports

Orders, finance/transactions, FBN inventory aging, and product views & sales sync on a schedule into your warehouse — query them instantly with query_report_data, exactly like Amazon report tables.

Available Tools (51)

A full Google Sheets toolkit — Claude handles these automatically when working with your data. Highlights:

Available Tools (27)

Available Tools (15)

Save files from URLs, copy, share, search, and organize files. Reports and exports are automatically saved to your Drive workspace.

Available Tools (11)