Skip to content

How to Connect to Seer MCP

This guide walks you through connecting to Seer's centralized MCP platform for your agent workflows.

How Seer MCP Works

flowchart LR
    subgraph AGENT["🤖 AI Agent"]
        C["Command<br/>/content-audit"]
    end

    subgraph MCP["☁️ Seer MCP (Cloud)"]
        M1["BigQuery Tools<br/>Rankings, traffic"]
        M2["Workflow Library<br/>Pre-built processes"]
        M3["Wil's Presentations<br/>Search & retrieve"]
    end

    subgraph DATA["📊 Data Sources"]
        D1["BigQuery"]
        D2["DataForSEO"]
        D3["Wrike"]
    end

    C <-->|"MCP Protocol"| M1 & M2 & M3
    M1 & M2 & M3 <--> D1 & D2 & D3

    style AGENT fill:#5050BC,color:#fff
    style MCP fill:#5050BC,color:#fff
    style DATA fill:#343456,color:#fff

Seer MCP is centralized. You don't need to set up local API keys or manage credentials—authentication happens through your Seer Google Account via OAuth.

Quick Setup Checklist

  • Use Claude Web Browser (claude.ai) for initial setup
  • Be in the Seer Team Plan workspace
  • Have your Seer Google Account ready
  • Connect to SEERMCP connector

That's it. No environment variables. No API keys. No local configuration.

Step-by-Step Connection

For Claude (Web/Desktop)

  1. Open Claude at claude.ai

  2. Use the web browser for initial setup (Desktop app can be buggy during first connection)

  3. Access Connectors

  4. Click the + (Plus) icon in the bottom-left

  5. Select Connectors → Manage Connectors

  6. Connect to SEERMCP

  7. Scroll to find SEERMCP

  8. Click Connect

  9. Authenticate

  10. Sign in with your Seer Google Account

  11. Authorize all requested permissions

  12. Verify Connection

  13. The connector should show "Configured" or "Connected"
  14. Start a new conversation to load the tools

For OpenCode / Claude Code CLI

For CLI users (builders), add Seer MCP to your configuration:

~/.claude/.mcp.json or ~/.config/opencode/mcp.json: 

{
  "mcpServers": {
    "seer-mcp": {
      "url": "https://seer-mcp.run.app",
      "auth": {
        "type": "oauth",
        "provider": "seer"
      }
    }
  }
}

The OAuth flow will prompt you to authenticate via browser on first use.

What You Get Access To

Once connected, you have access to these tool categories:

Category Tools Purpose
BigQuery/SeerSignals 4 tools Query 2+ years of paid media, SEO, CRM 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 data

See Seer MCP Specification for complete tool reference.

Verify Your Connection

Quick Test

Start a new conversation and ask:

What tools do you have access to from Seer MCP?

You should see tools like seersignals_run_query, workflowlibrary_list_workflows, etc.

Test a Query

Try a simple BigQuery query:

List the available datasets in SeerSignals

If connected, you'll see datasets like 0_meta, 1_google_ads, 2_organic, etc.

Troubleshooting

"Connector not appearing"

Cause Solution
Not in Seer workspace Switch to Seer Team Plan in Claude settings
Page not refreshed Refresh the browser page
Cache issue Try incognito/private browsing mode

"Authorization fails"

Cause Solution
Wrong Google account Use your @seerinteractive.com account
Permissions not granted Re-authorize and accept all permissions
Browser blocking popup Allow popups for claude.ai

"Tools not working after connecting"

Cause Solution
Old conversation Start a new conversation (tools load at start)
Connection dropped Reconnect via Manage Connectors
Server issue Check #inn-prototype-seer-mcp in Slack

"Query returns no results"

Cause Solution
No data for that client Verify client has data in SeerSignals
Wrong date range Check available date ranges in the dataset
Permissions Some datasets have restricted access

For Builders: Local Development

If you're developing new MCP tools or testing locally, you may need additional setup. See the Seer MCP Technical Specification for:

  • Local development environment setup
  • Creating new tools
  • Testing workflows
  • Contributing to Seer MCP

Graceful Degradation

All agent commands work even if Seer MCP is temporarily unavailable:

Command With MCP Without MCP
/content-audit Auto-fetch rankings from BigQuery Manual CSV/data input
/search-landscape Auto-fetch SERP data Manual competitor analysis
/time-tracking Sync with Wrike Export to clipboard

The agent will guide you through providing data manually if needed.

Reference

Tutorials

Support

Last updated: 2026-01-26