Opttab MCP server
Connect Claude, ChatGPT, Grok, Claude Code or Cursor to Opttab's MCP server so your AI assistant can read one workspace's AI visibility data.
Opttab runs an MCP server. MCP (Model Context Protocol) is an open standard that lets an AI assistant call tools from another service. Connect your assistant once, then ask it questions such as "How visible is my brand in AI search this month, and which prompts am I weakest on?"
Settings › Billing.How it works
Find your server address
Open Settings › MCP. Server address shows the address to add to any MCP client, with a copy button. Clients that sign in with OAuth need no API key.
Connect a client
Claude, ChatGPT and Grok sign in with your Opttab account (OAuth). Claude Code and Cursor send an API key in a header.
Add to Claude
Settings › MCP › Connect a client, open the Claude tab and click Add to Claude. Claude opens its connectors with Opttab filled in.Connect
Sign in
Open connectors
Settings › Connectors › Create (Business or Enterprise admins), or Plugins › Add › Add custom MCP server.Add Opttab
Create
Sign in
Add a connector
Plugins › New Connector › Custom.Add Opttab
Sign in
Create a key
Settings › API. See API keys.Add the server
Run:
claude mcp add --transport http opttab https://api.opttab.com/mcp \
--header "Authorization: Bearer opt_live_xxxxxxxx"
Create a key
Settings › API. See API keys.Add the server
Add this to .cursor/mcp.json:
{
"mcpServers": {
"opttab": {
"url": "https://api.opttab.com/mcp",
"headers": { "Authorization": "Bearer opt_live_xxxxxxxx" }
}
}
}
Settings › API.The sign-in screen
When an OAuth client connects, Opttab opens Connect {client} to Opttab:
- Choose a Workspace. Access reads "Read dashboard, prompts and analytics data".
- Click Allow access, or Cancel.
- You see "Connected — Taking you back to your AI assistant…"
The assistant acts as you. If you lose access to the workspace, so does the assistant.
| Item | Lifetime |
|---|---|
| Sign-in request | 15 minutes. After that, start again from the assistant. |
| Access token | 1 hour |
| Refresh token | 30 days |
Tools
Every tool reads the connected workspace and uses one MCP call. Many tools take a period (7d, 30d, 3m, 6m, 1y) and filters such as platforms, countries, topics, intents and tags.
| Group | Tools | What they read |
|---|---|---|
| Plan | get_plan_usage | MCP calls, agent credits and other meters left this period, with reset times |
| Dashboard (16) | dashboard_visibility, dashboard_sentiment, dashboard_citations, dashboard_leaderboard, dashboard_highlights, dashboard_topic_visibility, dashboard_market_visibility, dashboard_actions, dashboard_prompts, dashboard_topics, dashboard_responses, dashboard_discovered_brands, dashboard_sources, dashboard_platform_matrix, dashboard_prompt_outcomes, dashboard_series | Visibility, share of voice, sentiment, citations, leaderboard, per-topic and per-market visibility, recent answers, sources and daily series |
| Prompts (16) | prompts_list, prompts_filters, prompts_summary, prompts_get, prompts_trend, prompts_response, prompts_responses, prompts_search_queries, prompts_sources, prompts_citations, prompts_mentions, prompts_products, prompts_ads, prompts_maps, prompts_visibility_signals, prompts_signal_metrics | The prompts table, one prompt's detail and trend, full AI answers, fan-out searches, cited sources, mentions, products, ads, map results and search signals |
| Analytics (16) | analytics_filters, analytics_kpis, analytics_entities, analytics_funnel, analytics_prompts, analytics_sentiment_summary, analytics_sentiment_brands, analytics_sentiment_themes, analytics_sentiment_detail, analytics_theme_detail, analytics_citation_summary, analytics_citation_pages, analytics_publishers, analytics_publisher_detail, analytics_platform_matrix, analytics_platforms | KPI tiles, rankings, intent funnel, sentiment and themes, citation pages, publishers and per-engine values |
Text from AI answers and cited pages is marked as untrusted content. Your assistant treats it as data, never as instructions.
Usage and connected clients
Settings › MCP also shows:
- Connected clients: the assistants you signed in from, with Client, Workspace, Connected and Last used. Click Disconnect to end access at once.
- MCP calls this period: "{used} of {limit} used · renews on {date}", or "no limit on your plan".
- Writes: "Reads only. Your assistant can see your data but cannot change it."
When a call is refused
A refused tool call comes back to your assistant with the reason, your plan's limit, what you used, what is left and when it resets.
| Reason | Meaning |
|---|---|
PLAN_METER_EXHAUSTED | You have used this period's MCP calls. Check MCP calls this period for the reset date. |
PLAN_FEATURE_NOT_INCLUDED | Your plan does not include MCP access. |
NO_SUBSCRIPTION | The account has no active subscription. |