Skip to main content
Skip to content
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?"

Intraday

"Show me today's performance so far"

AI Agents

"What anomalies has Sonar detected this week?"

Prerequisites

  • A Claude account: Free, Pro, Max, Team or Enterprise. Free plans allow one custom connector. Claude connector guide →
  • Active Shurq account: at least one Amazon account connected. Sign up →
  • Shurq Pro plan or higher: MCP is included with Shurq Pro and Custom. View plans →

Limits and Top-ups

  • Monthly calls: Shurq Pro includes 20,000 MCP calls a month for each organization, plus 4,000 for each paid extra account.
  • Custom plans: your monthly limit is set in your contract.
  • Free trial: 1,000 MCP calls a month and 60 calls a minute per person. Everything else works as on Shurq Pro, including changes to bids and campaigns. Add a payment method to unlock 20,000 calls a month.
  • Daily limit: up to 10,000 calls a day per person. Your exact number is shown on your MCP dashboard.
  • Speed limit: 240 calls a minute per person on Shurq Pro.
  • Failed calls: calls that fail don't count.
  • Top-ups: 10,000 more calls for $50, one-time. They never expire and are used only after your monthly allowance runs out. Only organization owners and admins can buy them.

How to Connect

  1. 1

    Open Connectors

    In Claude.ai or Claude Desktop, go to Customize → Connectors.

  2. 2

    Add a Custom Connector

    Click "+", then "Add custom connector". On a Team or Enterprise plan, an Owner adds it once under Organization settings → Connectors, then each member clicks Connect.

  3. 3

    Enter MCP Server URL

    Copy and paste this URL:

    https://mcp.shurq.com/mcp

    Name it “Shurq” (or anything you prefer)

  4. 4

    Sign In

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

  5. 5

    Authorize Access

    Review the permissions and click Allow. This sign-in gives Claude read and write access to your Shurq data.

    Signing in grants read and write access. Write actions (bids, budgets, pauses, negatives, keywords, audiences) never run straight away: Claude shows a preview and waits for your confirmation in chat before anything is pushed to Amazon.

More Than 1,000 Tools: Example Categories

The server exposes more than 1,000 tools across 100 modules, including 29 write actions. The categories below are examples, not the full list.

CategoryWhat You Can Ask About
Ads PerformanceACoS, ROAS, spend, sales, campaigns, ad groups, keywords, targets, search terms, placements, budget pacing
Orders & ProductsOrder summaries, daily trends, top products, product deep dives, search, FBA inventory
Profitability (P&L)CM1-CM4 margins, daily P&L, per-product P&L, fee breakdown, COGS coverage, custom expenses
Brand AnalyticsOrganic rank, search volume, market share, SQP, SCP, Market Basket, Repeat Purchase, Top Search Terms
IntradayToday's performance, budget usage per campaign, hourly trends
AI OptimizationDeployed agents, Sonar events, bid/budget changes, guardrail settings
Flexible QueryList tables, view schema, run custom queries
Write ActionsBids, budgets, pauses, negatives, keywords, audiences. Each one is confirmed in chat before it reaches Amazon.

Example Prompts

Security & Privacy

  • Your data only: scoped to your Shurq accounts, no cross-tenant access
  • Confirmed writes: every write action (bids, budgets, pauses, negatives, keywords, audiences) shows a preview first and runs only after you confirm it in chat
  • OAuth 2.0: industry-standard authentication (same as Google, GitHub)
  • Revoke anytime: remove the connector in Claude’s settings at any time
  • 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). Free Claude plans allow one custom connector, so if you already use another one, remove it or upgrade your Claude plan.