Getting Started with Hopkin

What is Hopkin?

Hopkin gives AI assistants the ability to manage your advertising campaigns. Connect your ad accounts from Meta, Google, LinkedIn, Reddit, and TikTok, then use natural language to pull performance reports, analyze audiences, audit creatives, and monitor spend — all through conversation.

What you can do

• "Show me last week's performance across all my Meta campaigns"
• "Which Google Ads keywords are wasting budget?"
• "Break down my LinkedIn ads by job seniority and industry"
• "Compare creative performance on TikTok — which videos have the best completion rates?"
• "Pull a subreddit-level breakdown of my Reddit campaign spend"

Hopkin works with Claude Desktop, Notion, Claude Code, Cursor, Windsurf, and any MCP-compatible client.

Choose Your Client

Pick the installation guide for the tool you use:

• Claude Desktop — Add via Settings or config file. Best for non-technical users.
• Notion — Add as an MCP connection in Notion custom agents.
• OpenClaw — Install the Hopkin skill from ClawHub.
• Claude Code — Full MCP + plugin integration with pre-built skills.
• Cursor — Add to .cursor/mcp.json.
• Windsurf — Add to your Windsurf MCP config.
• VS Code — Add to .vscode/mcp.json.
• Other Clients — Direct server endpoints for any MCP-compatible client.

Your First Query

Once connected, try these three steps to verify everything works.

Step 1: Check Authentication

Ask your AI assistant: "Check my Hopkin auth status for Meta Ads"

This calls meta_ads_check_auth_status and confirms your account is connected.

Step 2: List Ad Accounts

Ask: "Show me my Meta ad accounts"

This calls meta_ads_list_ad_accounts and returns your account IDs, names, and statuses.

Step 3: Pull a Performance Report

Ask: "Give me last week's performance report for my Meta ads"

This calls meta_ads_get_performance_report with date_preset: "last_7d" and returns spend, impressions, clicks, conversions, and cost metrics.

The same pattern works across all platforms — just swap "Meta" for "Google", "LinkedIn", "Reddit", or "TikTok".

Available Servers

All servers share the same authentication model. One API key works across all platforms.

Authentication

For details on API keys, OAuth, and security, see the Authentication page.

Troubleshooting

"Authentication error" on first call: Your ad platform account may not be connected yet. Visit app.hopkin.ai to link your Meta, Google, LinkedIn, Reddit, or TikTok ad account via OAuth.

"Permission error" from platform API: The connected account may lack access to the requested ad account. Run check_auth_status to see which accounts are accessible.

Empty results from list tools: Try passing refresh: true to bypass the cache and fetch directly from the platform API.

MCP server not responding: Verify your API key is correct and hasn't expired. Generate a new key at app.hopkin.ai/api-keys if needed.