Install guide — Seller Foundation

Private beta

The marketplace URL is sent privately with each beta invite — apply on the signup page. The instructions below are accurate for what you'll do once you receive it.

Add our marketplace.

In Claude Cowork, open Settings → Plugins → Marketplaces → Add marketplace. Paste in our Git URL:

[ marketplace URL — sent with your beta invite ]

Claude fetches the marketplace manifest and shows our two plugins.

Install both plugins.

From the marketplace listing, click Install on:

amazon-foundation — integration skills (Amazon API plumbing)
amazon-business — outcomes (PPC, listings, pricing, inventory…)

Paste your license code.

On first use, the plugin prompts for your license. Paste the SF-LIVE-… code from your Account page. Cached locally; survives restarts.

Authorise Amazon.

Tell Claude "connect my Amazon account." A browser window opens on Amazon's own Login with Amazon page; approve the scopes Amazon shows you. The redirect lands at https://auth.lumitec.ai/callback, the refresh token is stored encrypted in our backend, and you're back in Claude.

Ask Claude something.

Try: "How many of my UK listings are suppressed?" or "What did I spend on Sponsored Products last week?" Reads return instantly; writes preview first.

Claude Code uses the same marketplace concept — just driven from the command line. One command to add, two to install.

# 1. add our custom marketplace (one-time)
claude marketplace add [ marketplace URL — sent with your beta invite ]

# 2. install both plugins from it
claude plugin install amazon-foundation
claude plugin install amazon-business

# 3. paste your license (or set it via env)
claude plugin config seller-foundation \
    --license SF-LIVE-7H2K-QM4P-V83N

# 4. trigger OAuth — opens a browser for Login with Amazon
claude plugin auth seller-foundation

# 5. verify
claude plugin test seller-foundation
› connected: Bamboo & Cork Co. (UK, DE, FR, IT, ES)
› Seller Central: ok · Advertising: ok · license: ok

# later — pull updates
claude marketplace update sellerfoundation
claude plugin upgrade amazon-foundation amazon-business

Pin a specific release for reproducibility by pointing at a tag: claude marketplace add [ marketplace URL — sent with your beta invite ]#v1.0.0

Troubleshooting

Most install issues are either the marketplace add or the OAuth hop. Check these first.

Paste the exact marketplace URL from your beta invite — no trailing slash, no .git. If you're on a corporate network, confirm github.com is reachable.

Restart Claude Cowork, or run claude plugin reload in Claude Code. New plugins are picked up on reload.

Check that your license is still within its 14-day trial (or that billing is active). Rotate it from the Account page if you suspect it's been shared.

Allow pop-ups from auth.lumitec.ai. On corporate networks, the callback URL needs to be reachable from your laptop.

You need at least one Amazon Advertising profile on the account. If you only use Seller Central and don't run ads, you can skip Ads — the plugin works in Seller-Central-only mode.

In Cowork: Settings → Plugins → Update all. In Code: claude plugin upgrade amazon-foundation amazon-business. Changelog lives at /changelog and on GitHub releases.

Yes — that's the point of shipping as an open marketplace. Every skill is plain Markdown + TypeScript. Read it, fork it, pin a commit. Writes to Amazon still go through our backend for token custody and rate-limit fairness; that part's documented on the security page.