Cogny MCP Server - Connect Claude to Your Marketing Data

What is the Cogny MCP Server?

Cogny's MCP (Model Context Protocol) server lets you connect Claude directly to your marketing data stack. Once connected, Claude can query your BigQuery warehouse, read Cogny's AI-generated reports, manage growth tickets, and access your organizational context — all through natural conversation.

Server URL: https://cogny.com/mcp

Protocol: JSON-RPC 2.0 over HTTPS (MCP spec 2024-11-05)

Authentication: OAuth 2.1 (authorization code flow with PKCE)

Quick Setup

In Claude Desktop / Claude.ai

Go to Settings > Connectors (or Settings > MCP in Claude Desktop)
Click Add custom connector
Enter the server URL: https://cogny.com/mcp
Authenticate with your Cogny account when prompted
Start chatting — Claude now has access to your marketing data

In Claude Code

Add to your MCP configuration:

{
  "mcpServers": {
    "cogny": {
      "url": "https://cogny.com/mcp"
    }
  }
}

Via the API (Anthropic MCP Client)

Use the Anthropic API with the mcp-client-2025-04-04 beta header to connect programmatically. See Anthropic's MCP documentation for details.

Available Tools

All tools include MCP safety annotations (readOnlyHint, destructiveHint, etc.) so Claude understands which tools are safe to call without confirmation.

BigQuery Analytics

Query your connected data warehouse directly.

Tool	Description	Safety
`list_datasets`	List all BigQuery datasets in your warehouse	Read-only
`list_tables`	List tables in a dataset (auto-groups GA4 sharded tables)	Read-only
`inspect_schema`	Get column definitions and CREATE TABLE statement	Read-only
`execute_bigquery_sql`	Run read-only SQL queries (SELECT/WITH only, 500 row limit)	Read-only

Example prompt: "What are my top 10 landing pages by conversion rate this month?"

Reports & Visualizations

Access Cogny's AI-generated marketing reports and render interactive charts.

Tool	Description	Safety
`list_reports`	List recent reports (SEO, Google Ads, CRO, etc.)	Read-only
`get_report`	Get full report content with all sections	Read-only
`get_report_section`	Get a section's SQL and chart config	Read-only
`show_report_section`	Render an interactive chart visualization	Read-only
`show_metrics`	Display configured core KPI metrics with trends	Read-only
`show_budget`	Show ad spend vs. monthly budget targets	Read-only

Example prompt: "Show me this week's SEO performance report"

Growth Tickets

Manage the actionable opportunities Cogny identifies from your data.

Tool	Description	Safety
`list_tickets`	List tickets with status/type filtering	Read-only
`get_ticket`	Get ticket details, body, and execution history	Read-only
`get_comments`	Get ticket comments (newest first)	Read-only
`get_ticket_source_context`	Get the report/analysis that created a ticket	Read-only
`create_ticket`	Create a new growth ticket	Write
`update_ticket_status`	Move ticket through workflow (new > doing > analysis)	Write
`add_comment`	Add a comment to a ticket	Write
`assign_ticket`	Assign or unassign a ticket	Write
`link_pr_to_ticket`	Link a GitHub PR for auto-status updates	Write

Example prompt: "What are my open growth tickets? Assign the top-priority one to me."

Organizational Context

A hierarchical knowledge graph for company strategy, competitor intel, and team knowledge.

Tool	Description	Safety
`browse_context_tree`	List child nodes at a path (or root categories)	Read-only
`read_context_node`	Read full node content with backlinks	Read-only
`search_context`	Full-text search across the context tree	Read-only
`get_context_tree_overview`	High-level structure overview	Read-only
`write_context_node`	Create or update a context node (upsert)	Write
`archive_context_node`	Soft-delete a context node	Destructive

Example prompt: "What do we know about our competitors' ad strategies?"

Connected Platforms

Cogny federates tools from your connected ad platforms. These appear as namespaced tools (e.g., mcp__google_ads__execute_gaql) and vary based on your connected integrations.

Supported platforms include Google Ads, Meta Ads, LinkedIn Ads, Search Console, and more.

Workspace Status

Tool	Description	Safety
`cogny_status`	Check subscription, connected channels, and features	Read-only

Authentication

Cogny uses OAuth 2.1 with authorization code flow and PKCE. When you add Cogny as a connector, your MCP client handles the OAuth flow automatically — you just sign in with your Cogny account.

Scopes: Access is scoped to your warehouse. You can only query data, reports, and tickets belonging to workspaces you're a member of.

Token refresh: Access tokens are short-lived and automatically refreshed by your MCP client.

Subscription Tiers

The tools available depend on your Cogny plan:

Feature	Solo ($9/mo)	Cloud
Context Tree	50 nodes	Unlimited
Growth Tickets	Via Findings	Full
BigQuery	-	Full
Reports & Charts	-	Full
Connected Ad Platforms	-	Full
Workspace Status	Full	Full

Solo tier users get access to findings, task queue, and context tree tools. Cloud tier unlocks BigQuery, reports, and connected platform tools.

Troubleshooting

"Unknown tool" error

Your subscription tier may not include that tool. Use the cogny_status tool to check your workspace status and available features.

Authentication fails

Ensure you're signing in with the email associated with your Cogny workspace
Check that your workspace has an active subscription
Try removing and re-adding the connector

No data returned from BigQuery

Verify your BigQuery warehouse is connected in the Cogny dashboard
Use list_datasets first to confirm available datasets
Check that your SQL query uses the correct dataset and table names

Connected platform tools missing

Connected platform tools only appear after you've linked the platform in your Cogny dashboard. Go to Settings > Integrations to connect Google Ads, Meta Ads, etc.

Timeouts on long queries

BigQuery queries are capped at 500 rows. If your query is timing out, add LIMIT clauses or narrow your date range.

Privacy & Security

All data stays within your Cogny workspace — Cogny does not share data between workspaces
BigQuery queries are read-only (SELECT/WITH only) — your data cannot be modified
OAuth tokens are scoped per-user and per-workspace
See our Privacy Policy for full details

Support

Email: support@cogny.com
Documentation: cogny.com/docs