MCP Integration

Connect Your AI Assistant to Shurq

Query your Amazon business data through Claude.ai using natural language. Ask about ads performance, P&L, organic rank, orders, inventory, and more — all scoped to your accounts.

What You Can Ask

Ads Performance

"How are my ads performing this month?"

Profitability

"Show me my P&L — where am I losing margin?"

Organic Rank

"What's my organic rank for 'wireless earbuds'?"

Orders & Products

"Which products are selling the most?"

Real-Time

"Show me today's performance so far"

AI Agents

"What anomalies has Sonar detected this week?"

Prerequisites

Claude.ai Pro or Max account — free plan doesn't support MCP integrations. Get Claude Pro→
Active Shurq account — with at least one connected Amazon account. Sign up→
Shurq Pro plan or higher — MCP access is a premium feature. View plans→

How to Connect

Open Claude.ai Settings

Go to claude.ai → click your profile picture → Settings

Navigate to Connectors

Click Connectors in the left sidebar

Add Custom Integration

Click "Add custom connector" (or "Add more" if you already have connectors)

Enter MCP Server URL

Copy and paste this URL:

https://mcp.shurq.com/mcp

Name it “Shurq” (or anything you prefer)

Sign In

Click Connect — you'll be redirected to Shurq's login page. Sign in with the same account you use for Shurq.

Authorize Access

Review the permissions and click Allow. Claude.ai now has read-only access to your Amazon data.

This is read-only — Claude cannot modify your campaigns, bids, or settings.

45 Tools Across 7 Categories

Category	Tools	What You Can Ask About
Ads Performance	11	ACoS, ROAS, spend, sales, campaigns, ad groups, keywords, targets, search terms, placements, budget pacing
Orders & Products	6	Order summaries, daily trends, top products, product deep dives, search, FBA inventory
Profitability (P&L)	7	CM1-CM4 margins, daily P&L, per-product P&L, fee breakdown, COGS coverage, custom expenses
Brand Analytics	8	Organic rank, search volume, market share, SQP, SCP, Market Basket, Repeat Purchase, Top Search Terms
Real-Time	3	Today's performance, budget usage per campaign, hourly trends
AI Optimization	4	Deployed agents, Sonar events, bid/budget changes, guardrail settings
Flexible Query	3	List tables, view schema, run custom queries (20+ tables)

Example Prompts

“Give me an overview of my ads performance for the last 2 weeks”

“Which keywords have the worst ACoS? Show me the top 10”

“What's my organic rank for 'wireless earbuds' and how has it changed?”

“Show me my P&L breakdown — where am I losing margin?”

“Compare my SP vs SB vs SD performance”

“Which products have no COGS data? I need to update my costs”

“Show me today's real-time performance so far”

“What anomalies has Sonar detected this week?”

Security & Privacy

Your data only — scoped to your Shurq accounts, no cross-tenant access
Read-only — no changes to campaigns, bids, or settings possible
OAuth 2.0 — industry-standard authentication (same as Google, GitHub)
Revoke anytime — disconnect from Claude.ai settings or Shurq settings
No data cached — queries execute live against your databases
Parameterized SQL — all queries are injection-proof

Troubleshooting

Make sure you're using https://mcp.shurq.com/mcp (not /api/mcp or just /sse). Verify you have a Claude Pro or Max account — free accounts don't support MCP integrations.

ChatGPT Integration — Coming Soon

ChatGPT MCP support is rolling out. The connection flow will be similar to Claude.ai.