What is tool4seller MCP?
MCP (Model Context Protocol) is an open protocol that connects AI tools with external data services.
After connecting to tool4seller MCP, you can query your Amazon store data, analyze business performance, and create or update ads through natural-language conversations in AI tools that support MCP, such as ChatGPT, Claude, and Codex. You can also retrieve organic search terms for an ASIN, access Amazon Brand Analytics (ABA) data, view keyword ranking trends, and manage keyword tracking for your products and competitors.
For example, you can ask your AI assistant to analyze why sales have declined, identify products running low on stock, propose budget and bid adjustments based on advertising performance, or set up keyword tracking and compare rankings with competitors. Before any creation or modification, the system displays a preview of the affected items and proposed changes. It executes the current plan only after you explicitly confirm it. Any new plan requires separate confirmation.
What can tool4seller MCP do?
tool4seller MCP supports business data queries, performance diagnostics, and advertising management. It also provides organic search term and ABA data queries, keyword ranking trends, and keyword tracking management across the following areas:
| Data Type | Description |
|---|---|
| Account and Store Information | View the current user’s default currency, time zone, display language, and account creation time. For authorized stores, view seller and marketplace information, store activation status, and SP-API and Amazon Ads API authorization status. Check your account’s plan limits, current usage, and remaining capacity. |
| Business Performance Diagnostics | Use sales, traffic, profit, advertising, and inventory data from a single store to assess overall business performance, investigate sales changes and profit anomalies, evaluate advertising efficiency, and identify inventory risks. |
| Sales and Traffic | Retrieve sales summaries, daily trends, and SKU-level sales data for one or more stores. View sales and traffic metrics for a single store at the store, ASIN, or parent ASIN level. |
| Sales Orders | Retrieve orders and item details for a store by order date. View order IDs, order times, current statuses, SKUs, ASINs, quantities, and amounts. |
| Profit Data | Retrieve profit data for a single store over a specified date range, with breakdowns by store, SKU, ASIN, or parent ASIN. |
| Inventory and Inventory Alerts | View FBA and merchant-fulfilled inventory for a single store, along with alerts for low stock, excess inventory, long-term storage, and recommended removals. Filter results by product and fulfillment method. |
| FBA Inbound Shipments | Retrieve FBA inbound shipments and their item details for one or more authorized sellers. Item details can be retrieved for up to 100 shipments per query. |
| Product Ratings | Retrieve ratings for parent ASINs with Review Tracking enabled in a single store. Parent ASINs without tracking enabled or available rating data are excluded from the results. |
| ASIN Organic Search Terms | Retrieve available organic search terms for an ASIN in a specified marketplace. For a parent ASIN, select a specific child ASIN before querying. |
| ABA Keyword Data and Trends | Retrieve Amazon Brand Analytics (ABA) keyword data, including search rank, search volume, click share, and conversion share. View historical weekly trends in search rank and search volume. |
| Keyword Ranking Trends | View daily ranking trends for keywords already tracked for your products or competitors, and compare rankings with linked competitors. |
| Keyword Tracking Management | View tracking settings, keywords, statuses, and linked competitors. Create, restore, or remove keyword tracking for products or competitors, and manage linked competitors. Changes require a preview and confirmation before execution. Competitor changes include a preview of the complete updated competitor list. Your account’s current tracking limits apply. |
| Advertising Performance and Attribution | View advertising performance for a single store at the store, SKU, ASIN, or parent ASIN level. Review search term performance, identify the products customers purchased after clicking ads, and view their attributed performance. |
| Advertising Campaigns and Structure | View information about campaigns, ad groups, product ads, and portfolios, including budgets, default bids, enabled or paused status, delivery status, and their relationships, where applicable. Product ad queries cover SP, SD, and SB ads. |
| Targeting and Negative Targeting | View performance, bids, and enabled or paused status for keyword, ASIN, category, and automatic targeting, including targets with no traffic. For negative keywords and negative ASIN targets, view match types, statuses, whether they are in effect, and their associated campaigns or ad groups. |
| Targeting and Bid Recommendations | Retrieve Amazon-recommended keywords or ASINs, along with suggested bids and bid ranges for targets. Bid recommendation queries support up to 100 targets at a time. Retrieving recommendations does not create targets or change bids. |
| Ad Creation | Create SP campaigns, supported ad groups, and product ads in supported SP or SD ad groups. Add keyword, ASIN, negative keyword, or negative ASIN targets. You can provide the required information in stages and resume working on a draft after an interruption. Creation plans are previewed for your confirmation before execution. |
| Ad Updates | Update supported campaign, ad group, ad, and target settings, including budgets, bids, names, and statuses. Ad name changes are available for supported SB ads. Negative targets can be re-enabled or archived where supported, but do not support bid changes. Archiving cannot be undone. All changes require a preview and confirmation before execution. |
Note: tool4seller MCP provides data queries, diagnostic tools, and management capabilities for ads, keyword tracking, and linked competitors. Your AI assistant analyzes and interprets the returned data. Querying data, retrieving recommendations, or generating a preview does not apply changes. Before any creation or modification, the system shows the affected items and proposed changes for your explicit confirmation. Confirmation applies only to the current plan; any newly generated plan requires separate confirmation.
Use Cases
Describe your business question in natural language. You can also specify the store, date range, filtering criteria, and changes you would like to make.
| Example Prompt | What tool4seller MCP Can Help With |
|---|---|
| Review my store’s performance over the last 7 days, compare it with the previous 7 days, and highlight the key metrics showing growth, declines, or unusual changes. | Summarize changes in business metrics and highlight key areas of growth, decline, and unusual fluctuations. |
| Why did my store’s sales volume decline this week? Analyze changes in traffic, conversion rate, advertising, and inventory, and identify the ASINs or SKUs with the greatest impact. | Investigate potential causes using traffic, conversion, advertising, and inventory data. Identify the products with the greatest impact and provide supporting data. |
| Why did my profit margin decline this month even though sales revenue increased? Identify the products with the greatest impact and analyze whether advertising costs contributed to the decline. | Break down profit changes by product to identify the main contributors to the decline and assess the impact of ad spend. |
| Find SKUs at risk of running low on stock and sort them by days of inventory remaining, from lowest to highest. Use average daily sales to recommend replenishment quantities and timing categories. | Generate a prioritized replenishment list showing inventory status, recommended replenishment quantities, and timing categories. |
| Review advertising performance over the last 14 days using clicks, orders, spend, ACOS, ROAS, and CPC. Identify wasted spend and growth opportunities, and generate an optimization plan for my approval. | Turn diagnostic findings into proposed budget, bid, and status adjustments, showing the affected items and their current and proposed values. |
| Find search terms in the US marketplace with at least 20 clicks, no orders, and more than $10 in spend over the last 14 days. Sort them by spend from highest to lowest. First, list the recommended negative keywords or ASINs. After I confirm which campaigns or ad groups to apply them to, generate a plan to add them in bulk. | Exclude existing negative targets, generate a recommendation list, and prepare a bulk change plan for the campaigns or ad groups you select. |
| Find targets with at least 20 clicks over the last 15 days. Reduce bids by 10% for targets with orders and an ACOS above 40%. Pause targets with no orders and more than $10 in spend. Generate a preview of the proposed changes first—do not apply them yet. | Filter targets based on the specified rules, calculate new bids, and generate a plan for bid adjustments and pauses. |
| Find search terms and ASINs with at least 20 clicks, at least 3 orders, and an ACOS below 40% over the last 30 days. Group your recommendations into tiers based on order count, ACOS, and conversion rate. First, provide a candidate list and a preview of the proposed campaigns. After I confirm, create separate manual campaigns for the selected targets, using Amazon’s suggested bids as the primary reference. | Identify promising targets for separate campaigns and prepare drafts for manual keyword-targeting and product-targeting campaigns, ready to create after your approval. |
| Retrieve all available organic search terms for ASIN B0XXXXXXXX in the US marketplace. | Retrieve the product’s available organic search terms. If a parent ASIN is provided, select a specific child ASIN before querying. |
| Show the daily organic rankings for all tracked keywords for ASIN B0XXXXXXXX in the US marketplace over the last 30 days, and compare them with linked competitors. | Display daily organic ranking trends and comparisons with linked competitors. |
| Create an organic rank tracker for ASIN B0XXXXXXXX and the keyword “test” in the US marketplace. First, check my account’s remaining tracking quota, then generate a plan preview and wait for my confirmation before creating the tracker. | Check eligibility and remaining tracking quota, preview the proposed setup, and create the tracker after you confirm the plan. |
| Add ASIN B0YYYYYYYY as a linked competitor for ASIN B0XXXXXXXX in the US marketplace, keeping all existing competitors. Show the complete updated competitor list and wait for my confirmation before applying the change. | Preview the complete competitor list after the proposed change, then apply the change after you confirm. |
| Show the latest ABA data for the search term “water bottle” in the US marketplace. | Retrieve the latest Amazon Brand Analytics (ABA) data, including search rank, search volume, click share, and conversion share. |
| Show orders and item details for the US marketplace over the last 30 days. | Summarize order counts, item quantities, and current order statuses, and display order IDs, order times, SKUs, ASINs, quantities, and amounts. |
Before You Begin
Before configuring tool4seller MCP, make sure the following requirements are met:
- You are using a tool4seller Primary Account or a User Account with access to stores that belong to that account. User Accounts cannot access stores assigned or shared by a Primary Account.
- The Amazon stores you want to query or manage are authorized under your current account and enabled.
- The relevant store must have valid Selling Partner API (SP-API) authorization to query business data and valid Amazon Ads API authorization to query advertising data or manage ads.
- Your current tool4seller plan includes MCP access. Check the pricing page for details on plan features.
- Your AI tool supports MCP. To connect using an MCP Key, it must also support Streamable HTTP and custom request headers.
Configure tool4seller MCP
Choose one of the following connection methods based on the AI tool you use:
| Connection Method | When to Use It |
|---|---|
| Connect Through the Plugin or Connector Directory | Install tool4seller from Plugins in ChatGPT or from Connectors in Claude, then sign in to your tool4seller account to authorize access. |
| Connect Using an MCP Key | Use this method to configure a custom MCP server, or when your AI tool does not provide a plugin or connector directory or does not list tool4seller. Your tool must support Streamable HTTP and custom request headers. |
Connect Through the Plugin or Connector Directory
When connecting through ChatGPT Plugins or Claude Connectors, sign in with your tool4seller account and password. SMS verification codes and third-party sign-in are not currently supported. If you have not set a password, set one in tool4seller first.
When authorizing the connection, select the account access permissions required for the data you want to query and the operations you want to perform. To create or update ads, enable read and write access for Campaign Management.
Configure in ChatGPT (Web or Desktop)
Install tool4seller
Open the tool4seller plugin page in ChatGPT and click Install.
Alternatively, search for tool4seller under Plugins in ChatGPT and install it.
Sign in to tool4seller
After installation, enter your tool4seller account credentials on the sign-in page that opens.
Confirm access permissions
Select the account access permissions you need, then confirm authorization.
Once authorized, follow the instructions in “Verify the Connection” below to check the connection status.
Configure in Claude (Web or Desktop)
Open the tool4seller connector
Open the tool4seller connector page in Claude.
Alternatively, open Search and tools in Claude chat, select Add connectors, search for tool4seller, and open the result.
Add the connector
On the tool4seller connector page, click Connect to Claude.
Sign in to tool4seller
Enter your tool4seller account credentials on the sign-in page that opens.
Confirm access permissions
Select the account access permissions you need, then confirm authorization.
Once authorized, follow the instructions in “Verify the Connection” below to check the connection status.
Connect Using an MCP Key
You can generate an MCP Key in tool4seller and enter it in your AI tool’s custom MCP configuration to authenticate access to tool4seller MCP.
Sign in to tool4seller and go to Data Service Platform → MCP Server.
Select Method 2: Configure with an MCP Key.
Generate and copy your MCP Key for use in the following configuration steps.
Note: Keep your MCP Key secure. Anyone who obtains your key may be able to access core business data for all stores authorized under your account. They may also perform supported creation or modification operations involving ads, keyword tracking, and linked competitors. Do not share your key. If you suspect it has been exposed, reset it immediately. You are responsible for any risks or losses resulting from key exposure, sharing, or misuse.
MCP Server Information
| Setting | Value |
|---|---|
| Name | tool4seller-mcp |
| Transport | Streamable HTTP |
| Server URL | https://das-server.tool4seller.com/mcp |
| Header Name | TS-MCP-KEY |
| Header Value | The MCP Key you generated in tool4seller |
General Configuration Example
If your AI tool supports adding MCP servers through a configuration file, use the following example as a reference. Replace <YOUR_MCP_KEY> with the MCP Key you generated.
{ "mcpServers": { "tool4seller": { "url": "https://das-server.tool4seller.com/mcp", "headers": { "TS-MCP-KEY": "<YOUR_MCP_KEY>" } } }}
Configuration formats may vary between AI tools. Follow the configuration requirements of the tool you are using.
Configure in Codex Desktop
Add a server
Open Settings, select Plugins, then choose Add → Add MCP server. Select Streamable HTTP as the connection type. If your app shows MCP servers directly in Settings, choose MCP servers → Add server instead, then select Streamable HTTP.
Enter the connection details
Set the name to tool4seller-mcp and the URL to https://das-server.tool4seller.com/mcp.
Add a request header
Enter TS-MCP-KEY as the header name and your generated MCP Key as the value.
Save the configuration
After saving, follow the instructions in “Verify the Connection” below to check the connection status.
Configure in Claude Desktop
These steps apply to Claude Desktop when signed in through a gateway, using the Managed MCP servers interface shown below. If this interface is unavailable in your setup, use the tool4seller connector directory method described above.
Add a server
Select Connectors in the left sidebar and add a new entry under Managed MCP servers.
Enter the connection details
Set Name to tool4seller-mcp, select Streamable HTTP for Transport, and enter https://das-server.tool4seller.com/mcp
as the URL.
Add a request header
Enter TS-MCP-KEY as the header name and your generated MCP Key as the value.
Save and restart
Click Apply Changes to save the configuration, then restart the Claude desktop app as prompted.
Once complete, follow the instructions in “Verify the Connection” below to check the connection status.
Verify the Connection
After completing setup, return to your AI chat, select or enable tool4seller, and enter:
"Show my current tool4seller account information and list each authorized store’s marketplace, activation status, and SP-API and Amazon Ads API authorization status."
If your account and store information is returned correctly, the connection is successful. Also check that the store you want to access is enabled and has valid API authorizations for the data queries or ad management tasks you want to perform.
Current Limitations
tool4seller MCP currently has the following limitations:
- Account Access: Primary Accounts can access stores authorized under the current account. User Accounts can access stores that belong to their account, but cannot access stores assigned or shared by a Primary Account.
- Feature Availability: Available features depend on your current plan, store status, relevant API authorizations, and the access permissions granted when connecting.
- Plugin or Connector Sign-In: When authorizing through ChatGPT Plugins or Claude Connectors, you must sign in with your tool4seller account and password.
- Changes and Confirmations: Before any creation or modification, the system generates a preview of the affected items and proposed changes. It executes the current plan only after you explicitly confirm it. Any newly generated plan requires separate confirmation.
Frequently Asked Questions
Will the AI create or modify anything without my confirmation?
No. Before any creation or modification, the system generates a preview showing the affected items and proposed changes. tool4seller MCP executes the current plan only after you explicitly confirm it, then returns the results. Any new plan requires separate confirmation.
What is the difference between tool4seller MCP and tool4seller CLI? Do I need to configure both?
No. You only need to configure the one that matches your AI tool.
Both tool4seller MCP and tool4seller CLI allow you to access your tool4seller data, but they are designed for different types of AI tools.
- tool4seller MCP: Designed for AI tools that support MCP, such as ChatGPT, Claude, and Codex.
- tool4seller CLI: Designed for AI coding assistants that can execute local commands, such as Claude Code and Codex CLI.
Choose the integration method that matches your workflow. You do not need to configure both.
Can I use tool4seller MCP with a User Account?
Yes. A User Account can use tool4seller MCP to access data for stores that belong to that account.
However, a User Account cannot access stores that have been assigned or shared by a Primary Account. To access data for those stores, sign in with the corresponding Primary Account.
