Seer MCP Reference¶
Complete reference for the Seer MCP platform and available tools.
Overview¶
Seer MCP is a centralized, cloud-hosted Model Context Protocol platform. It provides tools, workflows, and data access to any LLM front-end (Claude, Open WebUI, NinjaCat, etc.).
┌─────────────────────────────────────────────────────────────────┐
│ agents-infra (Workflow Layer) │
│ - Division plugins (SEO, Analytics, Operations) │
│ - Commands like /content-audit │
│ - CONSUME Seer MCP tools for external data │
└─────────────────────────────────────────────────────────────────┘
│
┌─────────────────────────────────────────────────────────────────┐
│ SEER MCP (Cloud Hosted) │
│ - Centralized authentication (OAuth) │
│ - BigQuery access, Workflows, Presentations, AI Search Volume │
│ - No local setup required │
└─────────────────────────────────────────────────────────────────┘
│
┌─────────────────────────────────────────────────────────────────┐
│ External Services (Managed by Seer MCP) │
│ - BigQuery, DataForSEO, Wrike, Vector DB │
└─────────────────────────────────────────────────────────────────┘
Key Point: Users connect to Seer MCP via OAuth—no API keys or local credentials needed.
Available Tool Categories¶
| Category | Tools | Purpose |
|---|---|---|
| BigQuery/SeerSignals | 4 tools | Query paid media, SEO, CRM, time tracking data |
| Workflow Library | 2 tools | Run pre-built deterministic processes |
| Wil's Presentations | 2 tools | Search and retrieve presentation content |
| AI Search Volume | 1 tool | Pull AI/LLM search volume from DataForSEO |
BigQuery/SeerSignals Tools¶
Read-only access to Seer's data warehouse with 2+ years of marketing data.
seersignals_list_datasets¶
List all available datasets in BigQuery.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | No parameters needed |
Returns: List of dataset names with prefixes indicating data type.
seersignals_list_tables¶
List tables within a specific dataset.
| Parameter | Type | Required | Description |
|---|---|---|---|
dataset |
string | Yes | Dataset name (e.g., 1_google_ads) |
seersignals_get_schema¶
Get the schema for a specific table.
| Parameter | Type | Required | Description |
|---|---|---|---|
dataset |
string | Yes | Dataset name |
table |
string | Yes | Table name |
seersignals_run_query¶
Execute a SQL query against BigQuery.
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | Yes | SQL query (SELECT only) |
max_rows |
integer | No | Maximum rows to return (default: 1000) |
Security: Only SELECT queries allowed. No DDL/DML operations.
Dataset Prefixes¶
| Prefix | Category | Example Tables |
|---|---|---|
0_ |
Meta/Reference | 0_meta.client_list, 0_meta.location_codes |
1_ |
Paid Media | 1_google_ads.campaign_performance |
2_ |
Organic/SEO | 2_organic.keyword_rankings, 2_organic.gsc_data |
9_ |
Operations | 9_wrike.time_entries, 9_wrike.tasks |
Workflow Library Tools¶
Pre-packaged, deterministic processes that ensure consistent outputs.
workflowlibrary_list_workflows¶
List all available workflows.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) | — | — | No parameters needed |
Returns: List of workflow names and descriptions.
workflowlibrary_fetch_workflow¶
Retrieve a specific workflow's instructions.
| Parameter | Type | Required | Description |
|---|---|---|---|
workflow_name |
string | Yes | Name of the workflow |
Returns: Complete workflow instructions (MCP Prompt format).
Available Workflows¶
| Workflow | Purpose | Output |
|---|---|---|
client_question_answerer |
Answer client questions with data | Branded HTML report |
paid_media_wins |
Identify positive paid media stories | Monthly performance summary |
ai_search_volume_analysis |
Analyze AI search trends | Volume comparison report |
Wil's Presentations Tools¶
Search and retrieve content from Wil Reynolds' presentations.
search_wils_recent_presentations¶
Search presentation content by keyword.
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | Yes | Search term |
limit |
integer | No | Max results (default: 10) |
fetch_wils_recent_presentations¶
Retrieve full content of a specific presentation.
| Parameter | Type | Required | Description |
|---|---|---|---|
presentation_id |
string | Yes | Presentation identifier |
AI Search Volume Tool¶
get_ai_search_volume_tool¶
Get AI/LLM-specific search volume data from DataForSEO.
| Parameter | Type | Required | Description |
|---|---|---|---|
keywords |
array | Yes | List of keywords |
location_code |
integer | No | Location (default: 2840 = US) |
Returns: Search volume data including AI Overview triggers.
Commands Using Seer MCP¶
| Command | Tools Used | Fallback |
|---|---|---|
/content-audit |
seersignals_run_query |
Manual data input |
/search-landscape |
seersignals_run_query, get_ai_search_volume_tool |
Manual analysis |
/time-tracking |
BigQuery via 9_wrike dataset |
Manual Wrike entry |
Graceful Degradation¶
All agent commands handle Seer MCP unavailability gracefully:
| Scenario | Behavior |
|---|---|
| MCP available | Use tools for automated data retrieval |
| MCP unavailable | Prompt user for manual data input |
| Partial availability | Use available tools, fallback for others |
Example message when unavailable:
I couldn't connect to SeerSignals for ranking data.
Options:
1. Provide a CSV export from Search Console
2. Enter keywords and positions manually
3. Retry connection
Which would you prefer?
Error Reference¶
Common Errors¶
| Error | Meaning | Solution |
|---|---|---|
| "Not authorized" | OAuth session expired | Reconnect in Claude → Manage Connectors |
| "Query timeout" | Query took too long | Simplify query, reduce date range |
| "No data found" | Client/date has no data | Verify client exists in SeerSignals |
| "Rate limit exceeded" | Too many requests | Wait and retry |
BigQuery-Specific¶
| Error | Solution |
|---|---|
| "Dataset not found" | Check dataset name spelling, use list_datasets |
| "Table not found" | Check table name, use list_tables |
| "Column not found" | Use get_schema to verify column names |
Security Model¶
Authentication¶
- OAuth-based: Sign in with your Seer Google Account
- No local credentials: Users don't handle API keys
- Token management: Handled automatically by Seer MCP
Authorization (RBAC)¶
- Role-based:
user,alpha_tester,admin - Tool-level permissions: Each tool declares required roles
- Dataset-level: Some datasets have restricted access
Audit¶
- Centralized logging: All tool calls logged
- Query history: BigQuery queries tracked
- Access audit: Who used what, when
Innovation MCP Tools (seerlab.workers.dev)¶
The Innovation team hosts experimental MCP servers on Cloudflare Workers. These provide capabilities not yet in Seer MCP.
Wrike MCP (Recommended)¶
URL: https://wrike.seerlab.workers.dev/mcp
Full-featured Wrike integration with 32 tools—significantly more capable than Wrike's official MCP (~10 tools).
| Feature | Seer Wrike MCP | Wrike Official |
|---|---|---|
| Setup | 30 sec (Claude.ai native) | Requires mcp-remote |
| Tools | 32 | ~10 |
| Timelogs CRUD | ✅ Full | ❌ None |
| Dependencies | ✅ | ❌ |
| Comments | ✅ Full CRUD | Create only |
Quick Start:
1. Claude.ai → Settings → Integrations → Add MCP Server
2. Enter: https://wrike.seerlab.workers.dev/mcp
3. Complete OAuth (authenticate with Wrike)
4. Done!
Used by: Operations /time-tracking command
Full docs: plugins/infrastructure/mcp-servers/wrike/
Built by: Jordan Strauss, Innovation Team
Related¶
Specification¶
- Seer MCP Technical Specification - Complete technical details
How-To¶
- Connect to Seer MCP - Setup guide
- Troubleshooting - Common issues
Explanation¶
- Understanding Seer MCP - Conceptual overview
- Architecture - How MCP fits the system
Last updated: 2026-01-31