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→

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.