You can connect Claude, Cursor, ChatGPT, or any AI tool that supports MCP (Model Context Protocol) directly to your SparkLoop account. Once it's connected, you can ask about your earnings, partners, and payouts in plain language, no dashboard login required.
Step 1: Get your MCP server URL and API key
Your MCP server URL is always: https://mcp.sparkloop.app
Most AI tools including Claude and ChatGPT support OAuth, so you can connect directly with just that URL and sign in with your SparkLoop account. No API key needed.
Claude, ChatGPT, and Cursor
Add SparkLoop as a custom connector using the server URL above.
Sign in with your SparkLoop account when prompted.
VS Code or other AI tools without OAuth support
If your AI tool doesn't support OAuth for remote MCP connections, you'll need an API key instead:
Go to your dashboard: https://dash.sparkloop.app/tools/mcp.
Click Copy your API key.
Add SparkLoop to your tool's MCP configuration with the server URL above and your API key set as an x-api-key header.
For a more detailed setup guide and full API documentation, see the SparkLoop MCP Server documentation.
If your tool doesn't support remote MCP connections at all, you can bridge the connection using the mcp-remote package with your API key set as an environment variable.
⚠️ Important: Treat your API key like a password. Anyone with your key can access your SparkLoop account data. If you think your key has been exposed, contact SparkLoop support to reset it.
Step 2: Try it out
Once connected, ask your AI assistant a question about your account. Here are a few ready-to-run prompts to start with — copy any of these into your AI tool.
Top-earning recommendations
Find the paid recommendations bringing in the most revenue.
"Which of my paid recommendations earned the most in the last 30 days? List the top 5 with their earnings and confirmed referrals."
Earnings from signup flow by campaign
See which UTM-tagged campaigns driving people into your signup flow are actually earning.
"Break down my signup flow earnings by UTM campaign for the last 90 days, so I can see which campaigns are actually earning."
Recommendations worth adding
Surface fits for your specific audience, not just the biggest payout.
"Suggest 3 newsletters to recommend that look like a good fit for my audience, based on their descriptions and expected earnings per referral, not just the ones with the biggest payout. If a program is too new to have expected earnings data, let me know."
Free recommendation network
See how your free recommendation exchanges are performing.
"How many free recommendations am I currently sending and receiving, and how many confirmed referrals has that brought in over the last 30 days?"
Where is my spend going?
Break down partner program spend and CPA by partner.
"For the last 30 days, break down my partner program spend by partner, with the average CPA for each, sorted by spend."
Survey insights
Summarize what new subscribers are telling you.
"Summarize my welcome survey: the top answer for each multiple-choice question, and the main themes in the answers to my open-ended questions (ignore name, company and contact fields)."
Note: If you have a large account, some requests (like listing every partner) may come back truncated to keep responses fast. If that happens, try narrowing your question using a shorter date range or fewer results.
You can also ask your AI assistant to do some tasks like request partnerships with other newsletters or archive/reactivate certain recommendations and offers.
Troubleshooting
My AI tool says it can't connect. Double-check you copied the full server URL (https://mcp.sparkloop.app) exactly, with no extra spaces. If you're connecting with OAuth, make sure you completed the sign-in prompt with your SparkLoop account.
My AI tool says my API key is invalid. Your key may have been regenerated. Go back to your dashboard Settings → Integrations and copy a fresh one. (This only applies if you're connecting with an API key rather than OAuth.)
My AI assistant's answer looks wrong. MCP pulls live data straight from your account, but your AI assistant is the one interpreting it. Try asking a more specific question, or contact SparkLoop support if the underlying numbers themselves seem incorrect.
Frequently Asked Questions
Answers to common questions about connecting your AI assistant to SparkLoop with MCP. For setup steps, see How to connect your AI assistant to SparkLoop with MCP.
What is MCP?
MCP (Model Context Protocol) connects AI tools like Claude, Cursor, and ChatGPT directly to your SparkLoop account. Once connected, you can ask your AI assistant about your earnings, partners, and payouts in plain language, instead of logging into the dashboard.
What data can it see?
Only the data already in your own SparkLoop account: earnings, partner performance, payouts, survey responses, and similar. MCP doesn't have access to anything outside your account.
Can it make changes to my account?
Yes, for some things. Alongside reporting on your account, your AI assistant can take actions like adding or archiving a paid or free recommendation, or creating a campaign link — but only when you ask it to. SparkLoop's Auto-Pilot still handles automatic recommendation decisions on its own.
Does this replace Auto-Pilot?
No. SparkLoop's Auto-Pilot is still the one deciding which recommendations to make. MCP just gives you a faster way to see what's going on, it doesn't change how recommendations are chosen.
Do I need to request access?
No. MCP is available to all SparkLoop accounts. Go to https://dash.sparkloop.app/tools/mcp to get started.
Which AI tools work with SparkLoop MCP?
Any AI tool that supports the Model Context Protocol, including Claude, Cursor, and ChatGPT. See How to connect your AI assistant to SparkLoop with MCP for setup steps by tool.
Will my results ever be incomplete?
If you have a large account — lots of partners, campaigns, or history — some requests may come back truncated rather than returning everything at once. This keeps responses fast. If that happens, try narrowing your question (a shorter date range or fewer results) and asking again.
How do I disconnect MCP or reset my API key?
If you connected with OAuth (the default for tools like Claude and ChatGPT), just remove the SparkLoop connection from your AI tool's settings.
If you are connected with an API key, go to Settings → Integrations and generate a new key. This immediately disables the old one — then remove the connection from your AI tool's settings as well. Any other integrations that use your old API key will also stop working until you update them with the new key.
Where can I get help?
If you run into an issue not covered here, contact SparkLoop support.
