From hopkin
Build reports and analyze Reddit Ads campaigns using the Hopkin Reddit Ads MCP. Includes prerequisite checks, authentication flow, campaign and ad group performance reporting, community (subreddit) breakdown insights, and custom audience analysis.
How this skill is triggered — by the user, by Claude, or both
Slash command
/hopkin:hopkin-reddit-adsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill enables Claude to build comprehensive reports and analyze Reddit Ads campaigns via the Hopkin Reddit Ads MCP. Use this skill to:
This skill enables Claude to build comprehensive reports and analyze Reddit Ads campaigns via the Hopkin Reddit Ads MCP. Use this skill to:
Check for reddit_ads_ prefixed tools (e.g., reddit_ads_check_auth_status). If none are found, the MCP is not configured.
Inform the user and provide setup instructions:
The Hopkin Reddit Ads MCP is not configured. To use this skill:
- Sign up at https://app.hopkin.ai
- Add the hosted MCP to your Claude configuration:
{ "mcpServers": { "hopkin-reddit-ads": { "type": "url", "url": "https://reddit.mcp.hopkin.ai/mcp", "headers": { "Authorization": "Bearer YOUR_HOPKIN_TOKEN" } } } }
- Restart Claude after updating configuration
Pause execution until the user confirms, then re-verify.
reddit_ads_check_auth_status to verify authenticationNote: Reddit tokens have a 1-hour TTL but auto-refresh server-side. If a previously-authenticated user gets auth errors, direct them to https://app.hopkin.ai to reconnect.
t2_abc123). Use reddit_ads_list_ad_accounts to look up accounts. No prefix conversion needed (unlike Meta's act_ prefix).date_start/date_end (YYYY-MM-DD format). There is no date_preset parameter.When reddit_ads_list_ad_accounts returns multiple accounts, present them as a numbered list and ask the user to confirm which account to use.
| Meta | Notes | |||
|---|---|---|---|---|
| Ad Account | Ad Account | Customer | Ad Account | Flat — no manager hierarchy |
| Campaign | Campaign | Campaign | Campaign Group | Top-level org unit; holds objective and budget |
| Ad Group | Ad Set | Ad Group | Campaign | Targeting, bidding, scheduling, subreddit targeting |
| Ad | Ad | Ad | Creative | Ad content and format |
| Custom Audience | Custom Audience | User List | — | Retargeting and lookalike audiences |
No MCC equivalent — all accounts are accessible directly; no login_customer_id needed.
reddit_ads_check_auth_status — Verify auth and troubleshoot connection issues; only call when another tool returns an auth error, not proactivelyreddit_ads_list_ad_accounts — List accessible Reddit Ads accounts. Params: account_id?, account_ids?, limit, cursor, refresh, reasonreddit_ads_list_campaigns — List campaigns for an account. Params: account_id (required), campaign_id?, campaign_ids?, status? (ACTIVE/PAUSED/ARCHIVED), search?, limit, cursor, refresh, reasonreddit_ads_list_ad_groups — List ad groups with targeting and bid strategy details. Params: account_id (required), ad_group_id?, ad_group_ids?, campaign_id?, status?, limit, cursor, refresh, reasonreddit_ads_list_ads — List ads. Params: account_id (required), ad_id?, ad_ids?, ad_group_id?, status?, limit, cursor, refresh, reasonreddit_ads_list_custom_audiences — List custom audiences for retargeting and lookalike targeting. Params: account_id (required), audience_id?, audience_ids?, limit, cursor, refresh, reasonreddit_ads_get_performance_report — Primary analytics tool. Full-funnel report with breakdowns. Params: account_id (required), date_start (YYYY-MM-DD, required), date_end (YYYY-MM-DD, required), campaign_ids?, ad_group_ids?, ad_ids?, breakdown? (max 3 from: campaign, ad_group, ad, community, date, country, region, placement, device_os), reasonreddit_ads_get_account_summary — Account-level summary. Params: account_id (required), date_start (YYYY-MM-DD, required), date_end (YYYY-MM-DD, required), reasonreddit_ads_render_chart — Render interactive data visualization charts as MCP App UI. Always call this when the user requests a chart, graph, map, or visualization — never substitute a table or text summary. Fetch data first, then pass it here. Params: chart (config with type + data), reason. Chart types: bar, scatter, timeseries, funnel, waterfall, choroplethreddit_ads_store_preference — Store a persistent preference for a Reddit ad entity (infer from recurring patterns). Params: entity_type (ad_account|campaign|ad_set|ad), entity_id, key, value, reasonreddit_ads_get_preferences — Get all stored preferences for an entity. Params: entity_type, entity_id, reason. Preferences also auto-attach to list tool responses as _stored_preferences.reddit_ads_delete_preference — Delete a stored preference by key. No-op if it doesn't exist. Params: entity_type, entity_id, key, reasonreddit_ads_developer_feedback — Submit feedback about missing tools, improvements, bugs, or workflow gaps in the MCP toolset. Not for user-facing auth/API errors. Params: feedback_type (new_tool|improvement|bug|workflow_gap), title, description, priority?, current_workaround?, reasonreddit_ads_ping — Health check and connectivity test. Params: message?, reasonNote: Every tool call requires a
reason(string) parameter for audit trail.
reddit_ads_get_performance_report supports a community breakdown dimension that provides subreddit-level performance data — unavailable on any other ad platform:
breakdown: ["community"] to see which subreddits drive the best resultsbreakdown: ["community", "date"] for subreddit trends over timecampaign, ad_group, ad, community, date, country, region, placement, device_osCommunity breakdown is the only way to get subreddit-level data — there is no separate
get_insightstool.
Reddit ads behave like organic posts and include unique engagement metrics:
video_started, video_watched_3s, video_watched_5s, video_watched_10s, video_watched_25%, video_watched_50%, video_watched_75%, video_watched_95%, video_watched_100%purchase, add_to_cart, lead, page_visit, search, sign_up, view_contentThe MCP is read-only. When a user requests write operations (pause campaigns, adjust budgets, etc.):
reddit_ads_developer_feedback with feedback_type: "workflow_gap" to report the gap to the development teamAnalyze top-level campaign performance, compare campaigns, and understand conversion metrics by objective.
Primary tool: reddit_ads_get_performance_report with breakdown: ["campaign"]
See detailed workflow: references/workflows/campaign-performance.md
Analyze subreddit-level performance to understand which communities drive the best results — a Reddit-exclusive capability.
Primary tool: reddit_ads_get_performance_report with breakdown: ["community"]
See detailed workflow: references/workflows/community-insights.md
Evaluate ad group targeting effectiveness, bid strategy performance, and subreddit targeting configuration.
Primary tools: reddit_ads_list_ad_groups + reddit_ads_get_performance_report with breakdown: ["ad_group"]
See detailed workflow: references/workflows/audience-targeting.md
reddit_ads_list_ad_accounts to find and confirm the accountdate_start/date_end (YYYY-MM-DD)reddit_ads_list_campaigns to get campaign config.campaign_id to drill into a campaign.ad_group_id to scope to an ad group.reddit_ads_list_custom_audiences to review audience composition.date_start/date_end in YYYY-MM-DD format — there is no date_preset parameterReddit returns budget values in micro units — divide by 1,000,000 for actual currency amounts. For example, a value of 50000000 = $50.00.
Reddit's API has an approximately 1 request/second rate limit. Use the refresh parameter sparingly — cached data is returned by default. Only set refresh: true when you need the latest data and the user has indicated data may be stale.
Reddit account IDs are plain strings — no prefix conversion needed (unlike Meta's act_ prefix). Use them exactly as returned by reddit_ads_list_ad_accounts.
reddit_ads_check_auth_status; if auth fails, direct to https://app.hopkin.ai to reconnectreddit_ads_list_ad_accountsdate_start/date_end (YYYY-MM-DD) — NOT date_preset or start_date/end_datebreakdown array — NOT pivotsget_insights tool — use get_performance_report with breakdowns for all analyticsact_)See references/troubleshooting.md for full guidance.
reddit_ads_list_ad_accountsrefresh: true callsSkill Version: 1.1 Last Updated: 2026-03-16 Requires: Hopkin Reddit Ads MCP (https://app.hopkin.ai)
npx claudepluginhub pearmill/hopkin-plugins --plugin hopkinCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.