Getting Started with SponserdIQ MCP
SponserdIQ exposes a Model Context Protocol (MCP) server that lets AI assistants like Claude Desktop query your sponsorship database directly. This guide walks you through the two connection methods.
Option A: Claude Desktop Custom Connector (Recommended) {#oauth-setup}
The easiest way to connect — no tokens or config files needed. Claude Desktop handles authentication automatically via OAuth.
1. Open Claude Desktop Settings
Click the + button under "Connectors" or go to Settings → Connectors → Add Custom Connectors.
2. Enter the SponserdIQ URL
- Name: SponserdIQ
-
URL:
https://sponserdiq.ai/mcp(or your organization's SponserdIQ URL)
3. Authorize
Claude Desktop will open your browser to log in to SponserdIQ. Enter your email to receive a magic link, then click Authorize on the consent screen to grant access.
That's it! SponserdIQ tools will appear in Claude Desktop automatically. The OAuth token lasts 30 days and Claude Desktop handles renewal.
Option B: Bearer Token (Claude Code, Cursor, other MCP clients) {#token-setup}
For MCP clients that support custom headers (Claude Code, Cursor, programmatic integrations), you can use a bearer token.
1. Generate a Token
Go to Account Settings and find the MCP Token section. Click Generate Token to create your bearer token. Copy it immediately — it is only displayed once.
Each user can have one active MCP token at a time. Generating a new token automatically revokes the previous one. Tokens expire after 30 days. You can revoke your token at any time from the same settings page.
2. Configure Your Client
The settings page shows the exact configuration snippet after token generation. For Claude Desktop (manual config) or Claude Code, add SponserdIQ to your configuration:
{
"mcpServers": {
"sponserdiq": {
"url": "https://sponserdiq.ai/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Replace YOUR_TOKEN_HERE with the token you copied in step 1.
3. Verify the Connection
After restarting your MCP client, you should see SponserdIQ tools available. Try asking Claude:
"Use SponserdIQ to get database stats"
If you see table counts for brands, properties, and sponsorships, the connection is working.
Try asking
Once connected, here are a handful of prompts that show off what SponserdIQ adds to Claude. Copy any of these straight into a Claude chat:
- "Show me at-risk renewals across NWSL."
- "Which CPG brands sponsor MLS this season? Group by tier."
- "Give me a portfolio snapshot of the LA Galaxy — top sponsors, industries, renewal health."
- "Compare Toyota's NASCAR and NFL partnerships — which is bigger and how have they trended?"
- "Which insurance brands are most active across college football?"
Trend & audit questions (powered by the historical snapshot table + Data Audit Agent):
- "How has Coca-Cola's at-risk count trended over the past 6 months?"
- "Which brands had the biggest net portfolio gain in Q1 2026?"
- "Which leagues lost the most sponsors in the last 90 days?"
- "Show me everything the audit agent removed for Brand X in the last 30 days."
Claude picks the right tools for each question. See the tools reference for the full inventory, or call get_example_questions from any client for the live, themed catalog.
Other MCP Clients
Any MCP-compatible client can connect using streamable HTTP transport. Point your client to the /mcp endpoint with either:
-
OAuth 2.1 — clients that support OAuth will auto-discover endpoints via
/.well-known/oauth-protected-resource -
Bearer token — set the
Authorization: Bearerheader directly
Troubleshooting
| Problem | Solution |
|---|---|
| Claude Desktop can't find the connector |
Make sure the URL uses https:// — Claude Desktop requires HTTPS |
| "No account found" on authorize page | You must have a registered SponserdIQ account first |
| Magic link expired | Magic links are single-use and expire quickly. Request a new one |
| Token stopped working | Tokens expire after 30 days. Generate a new one in Account Settings, or re-authorize via Claude Desktop |
| Tools not appearing in Claude Desktop | Restart Claude Desktop after updating the config or re-authorizing |
| OAuth consent screen not loading | Check that you're logged in to SponserdIQ in your browser |