Supported Amazon data and tools
Agentic Sellar exposes 33 operations to AI clients over MCP and REST. Live operations call Amazon at request time; retained operations read history Agentic Sellar has collected on Data plans and report where it came from and what dates it covers.
Discovery
Tools an AI client calls first to learn which accounts and operations it may use.
| Tool | What it does | Scope | Source |
|---|---|---|---|
list_accounts | List only the Amazon accounts authorized for this connection. | None | Agentic Sellar |
list_capabilities | List implemented tools, data modes, plan entitlements, and account requirements. | None | Agentic Sellar |
Amazon Ads
Sponsored Products reads, on-demand reports, curated bid, budget and state changes, and general Amazon Ads API access.
| Tool | What it does | Scope | Source |
|---|---|---|---|
get_campaign_performance | Read retained daily campaign performance for one authorized Ads profile. Data plans use the normalized Ads/Marketing Stream store; Access should use request_ads_report and get_ads_report. | ads:read | Retained history (Data plans) |
get_ad_performance | Read AMS-first ad performance at campaign, ad-group, ASIN, target, search-term and placement grains. Daily requests fill missing compatible buckets from retained Ads API reports. | ads:read | Retained history (Data plans) |
get_converted_product_performance | Read daily Marketing Stream conversions by advertised ASIN, converted ASIN, campaign, ad group and product relevance. | ads:read | Retained history (Data plans) |
list_ads_campaigns | List current Sponsored Products campaigns directly from Amazon Ads. | ads:read | Live from Amazon |
list_ads_ad_groups | List current Sponsored Products ad groups for a campaign directly from Amazon Ads. | ads:read | Live from Amazon |
list_ads_keywords | List current Sponsored Products keywords for an ad group directly from Amazon Ads. | ads:read | Live from Amazon |
request_ads_report | Request a live Amazon Ads report. Poll it with get_ads_report; results are not added to retained history. | ads:read | Live from Amazon |
get_ads_report | Poll a live Ads report and, once complete, return a bounded page of rows from Amazon's temporary report URL. | ads:read | Live from Amazon |
call_ads_api_read | Call any GET endpoint on the connected Amazon Ads regional host. Sellar supplies authentication and returns Amazon status, safe response headers and a bounded response body. | ads:read | Live from Amazon |
call_ads_api_writeChanges Amazon | Call any mutating Amazon Ads endpoint, including SP/SB/SD campaign, ad, keyword, target and placement operations. Requires ads:write and confirm=true. | ads:write | Live from Amazon |
update_ads_keyword_bidChanges Amazon | Update one Sponsored Products keyword bid directly in Amazon Ads. Requires ads:write and explicit confirmation. | ads:write | Live from Amazon |
update_ads_campaign_budgetChanges Amazon | Update one Sponsored Products daily campaign budget directly in Amazon Ads. Requires ads:write and explicit confirmation. | ads:write | Live from Amazon |
update_ads_campaign_stateChanges Amazon | Enable or pause one Sponsored Products campaign directly in Amazon Ads. Archiving is intentionally excluded because it is irreversible. | ads:write | Live from Amazon |
Seller Central (Selling Partner API)
Catalog, listings, orders, inventory and finances, plus general Selling Partner API access for the connected application.
| Tool | What it does | Scope | Source |
|---|---|---|---|
get_onboarding_status | Check whether Amazon Ads, Selling Partner API, and billing are connected. Use this first for a new workspace. | workspace:read | Live from Amazon |
begin_amazon_ads_connection | Create a secure Amazon Ads authorization link. Ask the user to open it; all available Ads profiles are connected automatically after Amazon consent. | workspace:write | Live from Amazon |
begin_amazon_seller_connection | Create a secure Selling Partner API authorization link. Ask the user to open it; all participating marketplaces are connected automatically after Amazon consent. | workspace:write | Live from Amazon |
get_subscription_status | Read the workspace's current subscription, entitlements, and retention deadline. | workspace:read | Live from Amazon |
begin_subscription_checkoutChanges Amazon | Create a secure Stripe Checkout link for a plan. Ask the user to open it to enter payment details. Requires confirm=true. | workspace:write | Live from Amazon |
begin_billing_portal | Create a secure Stripe Customer Portal link for plan changes, cancellation, invoices, or payment methods. | workspace:write | Live from Amazon |
get_usage | Read this month's agent work-unit usage and active-ASIN capacity. | workspace:read | Live from Amazon |
list_product_settings | List catalog ASINs and whether each is active for retained data collection. | workspace:read | Live from Amazon |
set_product_activeChanges Amazon | Activate or deactivate retained data collection for one ASIN in one marketplace. Requires a Data plan and confirm=true. | workspace:write | Live from Amazon |
get_revenue_and_costs | Read Business Reports-equivalent ordered sales and units with daily coverage, plus separately categorized posted financial amounts in native currencies. No profit or margin calculation. | seller:read | Retained history (Data plans) |
get_fee_records | Read posted-date Finances ledger records for one seller marketplace. Signed amounts, currency and native attribution are preserved. These records are not order-date economics or a complete fee reconciliation. | seller:read | Retained history (Data plans) |
get_catalog_item_live | Get one catalog item directly from SP-API without retaining the response. | seller:read | Live from Amazon |
list_seller_listings_live | List a page of the seller's current listings directly from SP-API without retaining the response. | seller:read | Live from Amazon |
get_order_metrics_live | Read daily order count, units, and total sales directly from SP-API without retaining the response. | seller:read | Live from Amazon |
get_inventory_live | Read one page of current FBA inventory directly from SP-API without retaining the response. | seller:read | Live from Amazon |
list_financial_events_live | Read one page of posted financial events directly from SP-API without retaining the response. | seller:read | Live from Amazon |
call_sp_api_read | Call any GET endpoint on the connected Selling Partner API regional host. Sellar supplies authentication and returns a bounded response. | seller:read | Live from Amazon |
call_sp_api_writeChanges Amazon | Call any mutating Selling Partner API endpoint available to the connected application, including Listings Items and Feeds workflows. Requires seller:write and confirm=true. | seller:write | Live from Amazon |
Request rules
- Account IDs come from
list_accounts; a connection only sees the accounts its grant covers. - Operations that take a date range use real
YYYY-MM-DDcalendar dates, are inclusive, and cover at most 366 days per request. - Large results are paginated. The cursor or page-token field and the page-size limits depend on the operation, and each tool’s input schema describes them.
- Write operations need a write scope and
confirm: true. Campaign archiving is excluded from the curated campaign-state tool. - Usage is measured in work units. Most simple requests use one unit; report generation uses more. Your dashboard shows current usage.
New to the two Amazon APIs? Read Amazon SP-API vs Amazon Ads API vs MCP for what each one covers.
Scopes and grants are explained in permissions and scopes. Signed-in members can see full request schemas in the API reference.