Overview
Yolodex gives DTC brands creative intelligence for Meta advertising: which creative works, why it works, and what to make next. The Yolodex connector brings that intelligence into Claude via the Model Context Protocol. Once connected, Claude can search your own ads and their performance, explore competitor creative from the Meta Ad Library, mine customer reviews and social conversations for voice-of-customer insight, and turn all of it into personas, creative briefs, and ad concepts.
The connector works in Claude.ai, Claude Desktop, Claude Mobile, and Claude Code.
Requirements
- A Yolodex account — sign in with Google at personas.yolodex.ai.
- Membership of at least one Yolodex organization. Organizations are invite-based — ask your organization owner for an invite, or contact support@yolodex.ai to get set up.
Connect from Claude.ai or Claude Desktop
- Open Yolodex in the Claude connectors directory — or find it via Settings → Connectors → Browse connectors — and click Add.
- You'll be sent to Yolodex to sign in with Google (if you aren't already) and approve the connection on the consent screen.
- Back in Claude, the connector shows as connected and its tools are available in new conversations.
You can also add Yolodex manually: choose Add custom connector under Settings → Connectors and enter the server URL:
https://personas.yolodex.ai/api/mcp
Authentication uses OAuth 2.0 (authorization code with PKCE) with dynamic client registration — there are no API keys to create or paste.
Connect from Claude Code
Add the connector from your terminal:
claude mcp add --transport http yolodex https://personas.yolodex.ai/api/mcp
The first tool call triggers the same browser-based OAuth sign-in and consent flow.
First steps
Ask Claude to get oriented first — the get_brand_overview tool returns your organizations, brands, and what data is available. From there, try prompts like:
- "What are our top-performing ads from the last 30 days, and what do they have in common?"
- "What hooks and angles are our competitors running right now?"
- "What do customers complain about most in our reviews?"
- "Which audience pain points show up in reviews but not in any of our ads?"
- "Draft a creative brief for a static ad aimed at first-time buyers."
- "Start tracking [competitor] and tell me when their ads are analyzed."
Searches match against AI-analyzed fields — audience segments, pain points, desires, hooks, messaging angles — not just raw ad copy or review text, so descriptive questions work better than single keywords.
What Claude can do
Available tools depend on your role in the organization. All members get read access:
- Your ads & performance— search your ad account's creative, pull performance metrics and indices, and analyze what's driving results.
- Competitor intelligence — search analyzed competitor ads from the Meta Ad Library across tracked brands.
- Voice of customer — search customer reviews, Reddit threads, Instagram and TikTok content, ad comments, and survey responses.
- Strategy artifacts — read personas, strategies, creative briefs, and reports your team has built.
Organization admins and owners additionally get write access:
- Track competitors — add brands and ad sources; ads are scraped and AI-analyzed automatically.
- Add data sources — connect review platforms (Trustpilot, Okendo, Yotpo, Bazaarvoice), Reddit, Instagram, and TikTok sources.
- Create — generate creative briefs, static ad concepts, and reports.
- Manage — organizations, members, routines, and integrations.
Multiple organizations
If you belong to one organization, everything is scoped to it automatically. If you belong to several, Claude lists them via list_organizationsand passes the organization's slug on each call — just name the organization you mean in your prompt ("in the Acme organization, …").
Data access & privacy
- The connector only accesses data in organizations you are a member of, with the same permissions you have in the Yolodex web app.
- Read access is available to all members; anything that writes or changes data requires an admin or owner role.
- OAuth tokens are stored encrypted; disconnecting the connector in Claude revokes them. You can also revoke access any time by contacting support@yolodex.ai.
See our Privacy Policy and Terms of Service for how we collect, use, and retain data.
Troubleshooting
- "You don't belong to any organizations" — your Yolodex account isn't a member of an organization yet. Ask your organization owner for an invite.
- Connection fails during OAuth — make sure you can sign in at personas.yolodex.ai with the same Google account, then retry the connection.
- A tool says it requires admin access — write operations (adding brands, generating briefs) need an admin or owner role in the organization.