Waldo MCP
Live marketing data for AI agents: ad libraries across Meta, Google, LinkedIn and TikTok, social listening, share of voice, audience insights and trends, with every answer linked to its source.
Documentation
Model Context Protocol
Use the Brand Intelligence API from Claude Desktop, VS Code, Cursor, and more
What is MCP?
The Model Context Protocol (MCP) is an open standard that allows AI applications to connect to external tools and data sources. Waldo's MCP server follows the authenticated remote MCP specification.
Once connected, your MCP client gets the full Brand Intelligence surface as tools — brands, mentions, owned and paid media, audiences, categories, discovery, and enrichment — plus workspace and API-key management.
Setup Instructions
Add the following server URL to your MCP client:
https://mcp.waldo.fyi
Authentication
Most MCP clients (Claude Desktop, Cursor, etc.) handle OAuth automatically — just add the server URL and authorize when prompted. For clients that don't support OAuth, generate an API key instead.
Go to API Keys
What's Available
The Waldo MCP server exposes two groups of tools:
Brand Intelligence Tools
The REST surface maps to tools one-to-one — brand_search, brand_mentions_summary, brand_paid_media_ads_list, audience_insights, category_landscape, and so on. Anything the API can do, your AI assistant can do.
Workspace & Key Management
Switch workspaces, check credits and usage, and manage API keys (api_key_create / api_key_list / api_key_revoke) without leaving your assistant.
Managing MCP Tools
Control which tools appear in your MCP client from the MCP Settings page. Toggle individual tools on or off, or use "Enable All" / "Disable All" for bulk changes.
Only enabled tools appear in your MCP client. Filter by status, scope, or category to find specific tools.
Configure MCP Tools
Claude Plugin
The Waldo fyi plugin bundles specialized strategy skills with a curated MCP connector at https://mcp.waldo.fyi/strategy. Unlike the full server, the strategy endpoint exposes a focused set of tools, and the plugin's skills know how to use them. Available in Claude Desktop (for Claude Code and Claude Cowork) and the Claude Code CLI.
Available Skills
A focused set of skills for working with ad tools, social tools, feeds, and your Waldo workspace. Skills trigger automatically based on your prompt, but slash commands are available as well.
Key Differences
The plugin connects to a separate curated endpoint (mcp.waldo.fyi/strategy) rather than the full server, so the toolset is fixed and the MCP Settings page does not apply. Skill routing is layered on top to help Claude pick the right tool for the job.
ChatGPT Integration
When connecting from ChatGPT, a curated subset of ~20 tools is exposed instead of the full 80+. This ensures reliable tool selection and stays within ChatGPT's connector size limits.
Available Tools
A focused set of brand-intelligence and workspace-management tools.
ChatGPT uses a simplified, fixed tool set — the MCP Settings page does not apply here.
Troubleshooting
Tools not appearing?
Make sure the tools are enabled in MCP Settings and that your workspace has Brand Intelligence access.
Authentication failed?
Check that your API key hasn't expired or been revoked. Generate a new one in API Keys. For OAuth, try disconnecting and re-authorizing.
Execution errors?
Make sure your team has an active subscription and available credits — check the balance with get_credits_balance or GET /v1/account/balance.