TrackIQ MCP Documentation
Everything you need to integrate your Amazon data with your AI assistant. Last updated April 30, 2026.
Quick Start
TrackIQ MCP connects your Amazon Seller Central account to Claude, ChatGPT, Cursor, or any MCP-compatible AI assistant. Follow these steps to get started:
Create an Account
Install the MCP server
For Claude Desktop:
claude mcp add trackiq "https://trackiq.com/mcp"
claude mcp list # verify installation
Copy
Copied
For Claude.ai, add a Custom Integration in Settings → Integrations.
Connect Amazon
Authorize via OAuth. We never see your password — Amazon issues a scoped token directly to TrackIQ.
Run your first query
Open your AI assistant and try:
claude mcp add trackiq "https://trackiq.com/mcp"
claude mcp list # verify installation
Copy
Copied
Note: Data is refreshed every 6 hours. For real-time queries, use the TrackIQ Platform web app instead.
Authentication
TrackIQ uses Amazon's official OAuth 2.0 flow. You authorize once; the token is valid for 12 months and auto-renews.
Scopes requested
•
sp-api:reports
— Sales, orders, returns
•
sp-api:advertising
— Campaign performance, keywords, search terms
•
sp-api:fba-inventory
— FBA inventory levels
•
sp-api:brand-analytics
— Brand Analytics (Plus tier only)
Revoke access any time from Seller Central → Apps & Services → Manage Your Apps.
Supported Clients
Scopes requested
CLIENT
PROTOCOL
SETUP GUIDE
Sales & Inventory Tools
get_sales
Daily revenue, units, and order count broken out by ASIN, parent SKU, or marketplace.
{
"tool": "trackiq.get_sales",
"date_range": "last_7_days",
"group_by": "asin"
}
Copy
Copied
get_inventory
FBA inventory levels per SKU per fulfillment center. Days-of-cover calculated automatically.
get_orders
Find specific orders by date range, status, or buyer-anonymized ID.
get_returns
Return reasons, rates, and SKU-level patterns.
Advertising Tools
get_campaigns
Spend, sales, ROAS, and ACoS by campaign across SP, SB, SD, and DSP.
get_keywords
Match type, bid, impressions, clicks, and conversion rate. Filter by ACoS thresholds.
get_search_terms
What customers actually searched for — including wasted spend and negative-keyword candidates.
See the full tool catalog for all 16 tools.
Write Actions (Plus Tier)
All write actions require explicit confirmation from your AI assistant before execution.
•
set_bid
— Update keyword bids
•
add_negative_keyword
— Add exact, phrase, or campaign-level negatives
•
set_budget
— Adjust campaign budgets
•
pause_campaign
— Pause or resume campaigns, ad groups, or keywords
Rate Limits
Scopes requested
TIER
TOOL CALLS / DAY
CONVERSATIONS / DAY
Free
50
10
Lite
500
100
Plus
Unlimited
Unlimited
Limits reset daily at midnight UTC. When you hit your limit, tools return a clear "limit reached" message.
Error Handling
TrackIQ returns structured error messages your AI assistant can parse:
{
"error": "rate_limit_exceeded",
"message": "Daily tool call limit reached. Upgrade to Lite or wait until reset.",
"reset_at": "2026-05-01T00:00:00Z"
}
Copy
Copied
Common errors:
•
auth_expired
— Re-authorize via OAuth
•
rate_limit_exceeded
— Upgrade or wait for daily reset
•
invalid_date_range
— Date range exceeds your tier's lookback limit
•
amazon_api_timeout
— Amazon's API is slow; retry in 30s
Data Retention
We cache responses for performance and rate-limiting. Caches expire within 24 hours. We don't train models on your data.
You can revoke access and trigger deletion at any time from Account Settings → Data & Privacy.
Need help?
or join our
