How to connect SparkToro to Claude Desktop, Claude Code, Cursor, ChatGPT, Gemini, and any other MCP-compatible AI client. Setup walkthroughs, what to ask, what the data means, and what to do when something goes wrong.
The SparkToro MCP server gives any MCP-compatible AI client access to SparkToro's audience research data. Once connected, your assistant can build audience reports, pull demographics, surface social accounts, and fetch any other section of a SparkToro report, all from a normal conversation.
https://mcp.sparktoro.com/mcp as a new MCP server in your client.MCP server URLs and config formats are still evolving across clients. If a snippet below doesn't match what you see in your client's UI, check the client's official MCP documentation. The server URL stays the same.
Pick the client you use. They all follow the same shape: add the server URL, click connect, sign in.
SparkToro is published in the ChatGPT Apps directory, so you do not need to configure a custom MCP server. Two ways to connect:
https://chatgpt.com/apps/sparktoro/asdk_app_69f57526ae808191b4b1a6aed91b0e68
ChatGPT app availability varies by region and plan tier. If the app does not appear when you search, your account may not yet have Apps enabled.
https://mcp.sparktoro.com/mcp
$ claude mcp add sparktoro https://mcp.sparktoro.com/mcp --transport http
claude mcp connect sparktoro. A browser window opens for OAuth.claude mcp list. SparkToro should be marked connected.{
"name": "sparktoro",
"transport": "http",
"url": "https://mcp.sparktoro.com/mcp"
}
~/.gemini/settings.json.mcpServers block:{
"mcpServers": {
"sparktoro": {
"httpUrl": "https://mcp.sparktoro.com/mcp"
}
}
}
/mcp inside the CLI to confirm SparkToro is connected and its tools are listed.The SparkToro MCP server uses standard OAuth 2.1 with PKCE. There's no API key to copy, paste, or rotate. Your MCP client handles the entire flow.
sparktoro.com.The MCP scope grants the connected client read access to SparkToro audience research on your behalf, plus the ability to create new audience reports. Tokens are scoped to your SparkToro account; the client cannot see other users' data.
To revoke a client's access, sign in to SparkToro and visit your API dashboard. Find the client in the Connected Apps card and click Revoke. The client's access and refresh tokens are invalidated immediately. You can also remove the server in your MCP client; the next refresh will fail and the connection will go dormant.
Your MCP client already knows these because the server returns them via tools/list. This table is here so humans can scan what's available without inspecting the protocol.
| Tool | What it does |
|---|---|
| create_report | Build a new audience report from a natural-language description. Returns a report_id and an initial status. |
| get_report_status | Check whether an in-progress report is ready. Used by clients to poll after create_report. |
| list_reports | List the audience reports tied to your account. |
| get_demographics | Age, gender, seniority, company size, salary, and location breakdowns. |
| get_tam | Total addressable market — the estimated size of the audience. |
| get_bio_keywords | The words your audience uses to describe themselves in their bios. |
| get_social | Social accounts your audience follows and engages with. |
| get_networks | Which social networks the audience is most active on. |
| get_websites | Websites your audience reads regularly. |
| get_press | Publications and press outlets your audience trusts. |
| get_new_podcasts | Podcasts your audience subscribes to and downloads. |
| get_youtube | YouTube channels your audience watches. |
| get_reddit | Subreddits where your audience participates. |
| get_keywords | Keywords your audience searches for. |
| get_apps | Mobile and desktop apps your audience uses. |
| get_prompts | Prompts your audience uses when talking to AI tools. |
Things to ask once you're connected. Each one stretches a different part of the toolset.
Restart the AI client after connecting. Some clients only refresh the tool list at startup or on a manual reload. In Claude Desktop, quit and relaunch the app.
Make sure you're signed in to SparkToro in the same browser your MCP client opens. Pop-up blockers can also kill the OAuth window. Try the connect flow again with pop-ups allowed for sparktoro.com.
Your access token has expired and the refresh token didn't renew. Disconnect the server in your MCP client, then reconnect. If the problem repeats, check whether the connection was revoked from SparkToro's connected apps settings.
Reports normally complete within 40 seconds. If get_report_status still returns processing after two minutes, the underlying job likely failed. Ask your AI to call create_report again. If the problem persists across multiple prompts, contact support with the failed report_id.
The audience may not have enough signal for that section. Niche or very small audiences can have sparse demographics, podcast lists, or keywords. Try a broader prompt and rebuild the report.
The first call to a section that hasn't been pre-warmed can take longer than your client's default tool timeout. Ask your AI to retry the call once. The retry hits a populated cache and returns quickly.
Your account has a per-period usage limit. If you hit it, the server returns a JSON-RPC error and your AI will surface the message. Check your usage in the SparkToro dashboard.
create_report, so we can debug failures and improve the audience-building model.Tool-call logs are retained for 90 days. create_report prompts and the resulting reports are retained for the lifetime of your account, so you can revisit past audiences. You can delete an audience report at any time from the SparkToro dashboard.
If you delete your SparkToro account, all your audience reports, MCP tokens, and associated logs are permanently removed within 30 days.
For the complete SparkToro privacy policy, see sparktoro.com/privacy. For data handling questions specific to MCP, contact support@sparktoro.com.
Add SparkToro to your MCP client and start asking your AI about your audience.