Documentation
Everything you need to connect your AI client to your Shopify store with SP Control MCP.
1. Overview
SP Control is a Model Context Protocol (MCP) server that acts as a secure bridge between your AI assistant and your Shopify store. Once installed, your AI client can query products, inspect orders, manage inventory, and more — all through natural language.
Pass-through architecture. SP Control does not store your store data. All product, order, and customer information flows directly between your AI client and the Shopify API. We act as a translator — your data is never cached or retained on our servers.
Key Benefits
- Natural language queries — Ask your AI "Show me unfulfilled orders from today" instead of navigating dashboards
- Any MCP-compatible client — Works with Claude Desktop, Cursor, Windsurf, and any other SSE-capable MCP client
- Safe write operations — Built-in safety checks warn you before bulk or destructive changes
- Single install, multiple clients — Your MCP URL works in all your AI tools simultaneously
2. Getting Started
Install from the Shopify App Store
Search for SP Control in the Shopify App Store and click Install. Grant the requested permissions — they are the minimum needed to operate the tools you use.
Copy your MCP URL from the dashboard
After installation you will be redirected to the SP Control dashboard. Copy your unique MCP URL — it looks like this:
https://spcontrol.dev/mcp/{your-shop-id}/sseTreat this URL like an API key. Anyone with this URL can read and (on Pro) write to your store.
Configure your AI client
Add the MCP server to your AI client using the instructions in the next section. No additional credentials are needed — the URL itself authenticates you.
3. AI Client Setup
SP Control uses the SSE (Server-Sent Events) transport, which is supported by all modern MCP clients. Select your client below for specific instructions.
Claude Desktop Configuration
Open your Claude Desktop config file and add the SP Control server under mcpServers:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"sp-control": {
"transport": "sse",
"url": "https://spcontrol.dev/mcp/{your-shop-id}/sse"
}
}
}
Restart Claude Desktop after saving. You should see SP Control appear in the tools panel.
Cursor Configuration
In Cursor, open Settings → Features → MCP and click Add new MCP server.
- Name: SP Control
- Type: SSE
- URL:
https://spcontrol.dev/mcp/{your-shop-id}/sse
Click Save. Cursor will connect to SP Control automatically when you start a new chat.
Any SSE-compatible MCP Client
SP Control exposes a standard SSE endpoint. For any MCP-compatible client, use the following endpoint:
# SSE endpoint (recommended) https://spcontrol.dev/mcp/{your-shop-id}/sse # HTTP endpoint (if your client requires it) https://spcontrol.dev/mcp/{your-shop-id}
Replace {your-shop-id} with the Shop ID shown on your SP Control dashboard. No authentication headers are required — the ID in the URL is your credential.
4. Tools Reference
SP Control provides 16 tools grouped into read operations (available on all plans) and write operations (Pro plan only).
List products from your store with optional filtering by status and keyword search.
Full-text search across product titles, tags, and descriptions.
List orders with filters for status, payment, and fulfillment state.
Retrieve full details for a single order including line items, shipping, timeline, and fulfillments.
Get today's snapshot: order count, revenue, and unfulfilled order count. No parameters required.
No parameters — returns today's stats automatically.
Retrieve store metadata: name, domain, plan, currency, timezone, and primary contact email.
No parameters required.
List or search customers by name, email, or phone. Returns order count and total spend.
Check stock levels for a product across all variants and locations.
List all collections (both custom and automated) with titles and product counts.
List all products within a specific collection.
List all store pages (About, FAQ, etc.) with titles and publication status.
Retrieve the full HTML body and metadata for a single store page.
Update product details including title, description, status, tags, and variant prices/inventory.
Create a discount code with fixed amount, percentage, or free shipping type.
Mark an order as shipped with optional tracking information. Sends a shipping notification email to the customer if requested.
Adjust stock quantity for a specific variant at a specific location. Use positive delta to add stock, negative to reduce.
5. Plans & Pricing
SP Control offers two plans. Billing is handled entirely through Shopify — no separate credit card required.
- 12 read-only tools
- 100 AI calls / month
- All MCP clients supported
- Dashboard & analytics
- All 16 tools (read + write)
- Unlimited AI calls
- Product & inventory management
- Discount creation
- Order fulfillment
- Priority support
Billing through Shopify. Upgrade or cancel at any time from your Shopify admin under Apps → SP Control. No separate account or credit card needed.
6. Safety Features
Write operations include built-in safety checks to prevent accidental or destructive changes. Your AI will warn you before proceeding with risky actions.
7. Frequently Asked Questions
No. SP Control is a pass-through bridge. Product, order, customer, and inventory data flows directly between your AI client and the Shopify API. We only store the minimum required to operate the service: your OAuth token, shop domain, and anonymous usage logs (tool names and response times — no request or response payloads).
Any client that supports the MCP standard with SSE transport. This includes Claude Desktop, Cursor, Windsurf, and any other tool that lets you configure a custom MCP server URL. If your client supports MCP, it works with SP Control.
Yes. Your MCP URL can be added to as many AI clients as you like — Claude Desktop and Cursor simultaneously, for example. Each client connects independently and all share the same Shopify connection.
Shopify sends a webhook immediately upon uninstall. We invalidate your OAuth token and MCP URL within seconds — any configured AI clients will stop receiving data. We retain anonymized usage logs for 90 days, then delete them. You can also request immediate deletion by contacting us.
Yes, with care. Write tools include safety warnings and confirmation prompts for risky operations. You should always review your AI's proposed actions before confirming. All write operations are logged so you have a full audit trail. We recommend starting with read-only access on the Free plan to get familiar with how your AI interprets your store data.
Yes. We implement Shopify's mandatory GDPR webhooks (customer data request, customer data erasure, shop data erasure). We do not store customer PII beyond what Shopify already holds. See our Privacy Policy for full details.
Read tools return a rate-limit error and suggest upgrading to Pro. Your store data is never modified at this point — only read operations are affected. The limit resets on the first day of each calendar month.
8. Support
We are here to help. Reach out through any of the following channels:
Email: support@spcontrol.dev
GitHub Issues: Report a bug or request a feature
We typically respond within 1–2 business days. For billing questions, you can also use the Shopify App Store support channel on the SP Control listing page.