Documentation
CreatorSense MCP Guide
How to connect your CreatorSense data to Claude, ChatGPT, and any MCP-compatible AI tool, so you can ask questions about your real creator revenue without leaving your AI assistant.
Coming soon
CreatorSense MCP Servers are currently in development and not yet available. This guide will be updated with live connection details when they launch. Book a desk demo or log in to the desk to stay ready for launch.
On this page
- What is MCP and why it matters for talent desks
- What Agency MCP gives you access to
- Plan requirements
- Step 1, Get your MCP API key
- Step 2, Connect to Claude
- Step 2 (alt), Connect to ChatGPT
- Other MCP-compatible tools
- What to ask once connected
- Agency MCP, roster-level access
- Troubleshooting
- FAQ
- Security and data handling
What is MCP and why it matters for talent desks
Model Context Protocol (MCP) is an open standard that lets AI tools connect directly to external data sources. Without MCP, if you want to ask your AI assistant a question about the book ("Which creators on my roster are at churn risk this month?"), you'd need to open the desk, copy numbers, paste them into chat, and ask again.
With CreatorSense Agency MCP, your AI tool connects directly to your desk account. You ask the question in your AI assistant and it queries real roster data automatically, no copy-pasting, no dashboard-switching.
The connection is read-only. The AI can see your data but cannot modify your account, connected platforms, or settings.
Example
You're in Claude, planning next month. You ask: "Which of my platforms had the highest revenue-per-post ratio last quarter, and what does ARIA recommend I focus on?" Claude queries CreatorSense MCP, gets your real revenue and ARIA data, and answers in seconds, all without you opening a browser tab.
What Agency MCP gives you access to
All data returned by the MCP server is the same data visible to you in the CreatorSense talent desk. Access depends on your Launch / Scale / Empire plan.
Agency MCP Launch+
- Portfolio-level revenue across your managed roster
- Per-creator revenue breakdown and platform mix
- Creator-level risk signals and churn indicators
- Roster-level ARIA insights and strategic briefs
Not accessible via MCP
Your platform credentials and OAuth tokens · Private messages on any platform · Payment card or bank details · Audience members' personal data · Other users' accounts
Plan requirements
| Plan | MCP access | Daily query limit |
|---|---|---|
| Launch $1,999/mo | Agency MCP, roster read tools | Shared desk pool |
| Scale $4,999/mo | Agency MCP, roster access | 500 queries/day |
| Empire $9,999/mo | Agency MCP, full access | Unlimited |
Query limits reset daily at midnight UTC. View talent desk pricing →
Step 1, Get your MCP API key
You need an API key to authenticate your AI tool with CreatorSense MCP.
Keep your key private
Your MCP API key grants read access to your account data. Never paste it into a public forum, share it with another person, or commit it to a code repository. If it's exposed, revoke it immediately from Settings → Integrations → MCP.
Step 2, Connect to Claude
Claude supports MCP via the Claude desktop app (Mac and Windows). The web app at claude.ai does not currently support MCP connections directly, use the desktop app.
your-api-key-here with your API key from Step 1
Save the file.
Step 2 (alt), Connect to ChatGPT
ChatGPT supports MCP via the custom GPT connector (ChatGPT Plus, Team, and Enterprise plans). The process uses your API key as a bearer token.
Other MCP-compatible tools
Any tool that supports MCP or custom HTTP tool connectors can connect to CreatorSense MCP.
-
Cursor / Windsurf / Zed use the same
claude_desktop_config.jsonformat; these editors read from the same config file or support a similar MCP server config block. -
Continue.dev add CreatorSense as an MCP provider in your
.continue/config.json. -
Custom scripts the MCP server exposes a JSON-RPC interface at
https://mcp.creatorsenseai.com. Pass your API key as a Bearer token in theAuthorizationheader.
For tool-specific instructions not listed here, contact support@creatorsenseai.com.
What to ask once connected
Once CreatorSense MCP is connected, your AI assistant can answer questions about your real creator data. Here are examples across common use cases:
Revenue & earnings
Cash flow & set-asides
Strategy & ARIA insights
Planning
Not financial advice
ARIA insights and desk set-aside estimates returned via MCP are AI-generated for planning purposes only. They are not financial, tax, or legal advice. Work with a qualified professional for filings, investment decisions, or legal matters.
Agency MCP, roster-level access
Agency MCP connects Claude to your CreatorSense desk via OAuth, no API keys. You must be an owner or manager of an active organization.
- Open claude.ai → Settings → Integrations → Add custom integration
- Enter:
https://agency-mcp.creatorsenseai.com - Log in with your CreatorSense agency account (same as the web app)
- Approve the connection
- Ask Claude about your roster
Launch: overview, roster, invites, invite/remove creators.
Scale / Empire: + contracts and commissions tools.
Example prompts:
Deploy / ops checklist: see MCP_LAUNCH_CHECKLIST.md in the repo. Plans:
Agency pricing · Demo:
Book a desk demo
Troubleshooting
"Authentication failed" or 401 error
- Check that you pasted the full API key, there should be no spaces before or after it.
- Verify the key hasn't been revoked in Settings → Integrations → MCP.
- Confirm your org is on a Launch, Scale, or Empire desk plan, Agency MCP is not available without an active talent desk subscription.
Claude doesn't see the MCP tool
- Ensure you fully quit and relaunched Claude desktop (not just closed the window).
-
Check your
claude_desktop_config.jsonfor JSON syntax errors, a missing comma or bracket will prevent the config from loading. Use a JSON validator if unsure. -
On Mac, the config file is at
~/Library/Application Support/Claude/claude_desktop_config.json. - On Windows, it's at
%APPDATA%\Claude\claude_desktop_config.json.
Data looks out of date
- MCP returns data from your CreatorSense account, which depends on how recently Data Sync ran. Check Settings → Connected Platforms to see your last sync time.
- Manual sync: go to your dashboard and trigger a sync from the platform panel.
"Query limit exceeded" error
- Daily query limits reset at midnight UTC. Check your plan's limit in the table above.
- If you're regularly hitting limits, consider upgrading your plan.
The MCP server isn't responding
- Check status.creatorsenseai.com for any ongoing incidents.
- Contact support@creatorsenseai.com with the error message and timestamp.
FAQ
- Can the AI tool modify my CreatorSense account or connected platforms?
- No. MCP access is strictly read-only. The AI can retrieve and analyse your data but cannot change settings, disconnect platforms, or take any action in your account.
- Does connecting Claude or ChatGPT mean Anthropic or OpenAI can see my creator data?
- When you ask a question, the AI tool sends your query to its own servers and then calls the CreatorSense MCP server for data. What the AI provider stores, including your question and the data returned, is governed by their own privacy policy, not ours. Review their privacy terms before connecting. We do not receive any data from the AI provider about your usage.
- Can I use MCP with multiple AI tools at the same time?
- Yes. Generate a separate API key for each tool (e.g. one for Claude, one for ChatGPT). This way you can revoke access to one tool without affecting the others. Each key has independent rate limits within your plan's daily total.
- What happens to my MCP access if I downgrade my plan?
- If you leave Launch / Scale / Empire (or drop below the plan that includes Agency MCP for your seat), your API keys are deactivated automatically. They are not deleted, if you upgrade again, existing keys will reactivate. Downgrading from Empire to Scale applies Scale’s daily query limit.
- Is there an MCP-specific privacy policy?
- Yes, creatorsenseai.com/mcp-privacy. It covers what data is accessible, what we log (and don't log), third-party AI tool responsibilities, and your controls.
- Can I share my API key with my team or VA?
- API keys are personal and tied to your account. Sharing a key means granting another person read access to your full creator revenue data. If you need team access, you would need separate CreatorSense accounts. Contact us if you have a team use case, we can advise.
- Is there a sandbox or test mode?
- Not currently. MCP connections always return live account data. We plan to add a sandbox environment in a future release.
- What if I found a security issue with the MCP server?
- Please report it to support@creatorsenseai.com with "Security: MCP" in the subject line. Do not test against live MCP endpoints without our written permission.
Security and data handling
A summary of how MCP data is protected:
- All connections are TLS-encrypted no data travels in plain text.
- API keys are hashed at rest we store an identifier, not the key itself.
- We log query metadata, not content we record timestamp, key ID, tool name called, and response status. We do not log your questions or the data returned.
- Rate limiting protects your account unusual query spikes trigger automatic key suspension and email notification.
- You can revoke access instantly deleting a key from Settings takes effect in under 60 seconds across all MCP endpoints.
Full details: MCP Privacy Policy · Security Policy