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://app.cogny.com/mcp

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

Authentication: OAuth 2.1 (authorization code flow with PKCE) — no API key needed; your MCP client handles the sign-in, and you pick which warehouse to authorize.

Tip: You can also use a warehouse-scoped URL of the form https://app.cogny.com/mcp/w/<your-warehouse-id> to skip the warehouse picker. Copy the exact URL for your workspace from Settings → MCP inside the app. Both the generic and scoped URLs work everywhere.

Quick Setup

In Claude.ai / Claude Cowork

Go to Settings → Connectors → Add custom connector
Enter the name cogny and paste the server URL: https://app.cogny.com/mcp
Click Add — Claude will prompt you to log in
In the popup, select your warehouse and click Authorize
Start chatting — Claude now has access to your marketing data

Connect Cogny to Claude in about 30 seconds

In ChatGPT

Go to Settings → Apps → Advanced settings and enable Developer mode
Click Create app, enter the name Cogny, and paste the server URL: https://app.cogny.com/mcp
Set Authentication to OAuth, check the risk acknowledgment, and click Create
In the popup, select your warehouse and click Authorize
To use it: click + in the chat box → More → Cogny

ChatGPT may prompt you to authorize twice on first use — this is normal.

Connect Cogny to ChatGPT (about 3 minutes)

In Claude Code (CLI)

Run this in your project directory — Claude Code handles the OAuth login automatically:

claude mcp add --transport http cogny https://app.cogny.com/mcp

Or, if you already have a Cogny API token, skip OAuth with a bearer header:

claude mcp add --transport http cogny https://app.cogny.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

In Codex CLI

Run this in your project directory — Codex detects OAuth and opens the authorization flow automatically:

codex mcp add cogny --url https://app.cogny.com/mcp

If the server is already added and you need to authenticate again, run codex mcp login cogny.

Via the API (Anthropic MCP Client)

Use the Anthropic API with the mcp-client-2025-04-04 beta header to connect programmatically against https://app.cogny.com/mcp. 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
`get_winner_status`	Long-term impact history of a winner ticket (trend, cumulative USD impact, check schedule)	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