Skip to content

indianappguy/talktoads

v1.0.0MIT

Run your Meta (Facebook + Instagram) ads by talking: reports, audits, reel boosts and campaigns that start paused until you say go.

You ask your agent "how did my ads do last week, and what should I kill?". It pulls spend, results, cost per result and ROAS per campaign and tells you which to scale and which to cut. You say "boost my latest reel to my site at ₹500 a day". It builds the campaign, ad set and ad, all paused, shows you the draft, and only goes live when you say yes.

  • Reports: spend, results, CPA, ROAS, CTR, CPM by campaign, ad set or ad, with age/gender/placement breakdowns
  • Audits: a 0–100 health score with wasted spend, ad fatigue, learning-limited ad sets and rejected ads
  • Build: boost an Instagram reel or post in one step, or create campaigns, ad sets and ads from scratch
  • Control: pause, change budgets, rename, with a change log and an optional daily spend cap
  • Memory: remembers your target CPA, brand voice and words to avoid across chats
  • Free plan: 15 tasks a month (talktoads.com)

Install

Every option uses the same skill (skills/talktoads/SKILL.md) and the same hosted MCP server, https://talktoads.com/mcp (sign in with Facebook, no API key).

AgentInstall
Any agent (skills.sh)npx skills add IndianAppGuy/talktoads-agent
Claude Code (plugin: skill + MCP)/plugin marketplace add IndianAppGuy/talktoads-agent then /plugin install talktoads@talktoads
Claude Code (MCP only)claude mcp add --transport http talktoads https://talktoads.com/mcp then /mcp to sign in
Claude.ai / Claude DesktopSettings → Connectors → Add custom connector → https://talktoads.com/mcp
Codexnpx skills add IndianAppGuy/talktoads-agent -a codex and codex mcp add talktoads --url https://talktoads.com/mcp && codex mcp login talktoads
Gemini CLIgemini extensions install https://github.com/IndianAppGuy/talktoads-agent
CursorAdd to Cursor + npx skills add IndianAppGuy/talktoads-agent -a cursor
OpenClawopenclaw skills install @theindianappguy/talktoads
Hermes Agenthermes skills install skills-sh/IndianAppGuy/talktoads-agent/talktoads
Any MCP clientStreamable HTTP server https://talktoads.com/mcp (OAuth 2.1 + dynamic client registration)

Tools

ToolWhat it does
list_ad_accounts, list_pages, list_instagram_posts, list_pixelsWhat you can run ads from
list_campaigns, list_ad_sets, list_adsWhat is running, with status, budgets and review feedback
get_performanceSpend, results, cost per result, CTR, CPM, ROAS, breakdowns, day by day
audit_accountHealth score and a prioritised fix list
search_interests, estimate_audience, list_custom_audiences, create_lookalike_audienceTargeting
boost_instagram_postReel or post → campaign + ad set + ad, paused
create_campaign, create_ad_set, create_adBuild from scratch, paused
go_live, pause, update_budget, renameControl (go_live only after you approve)
remember_brand_fact, recall_brand_memory, forget_brand_factBrand memory
get_change_log, get_usage, set_spend_capAudit trail, plan, safety cap

Try these prompts

  1. "How did my Meta ads do in the last 7 days? Which campaign should I scale and which should I kill?"
  2. "Audit my ad account for the last 30 days and give me the top 3 fixes."
  3. "Boost my latest Instagram reel to example.com at ₹500 a day, India, 25–45."
  4. "Pause every ad set with cost per purchase above ₹800."
  5. "Remember: target CPA is ₹300 and never say 'guaranteed' in ad copy."

Safety

  • Everything the agent creates starts paused. It goes live only after you say so in that chat.
  • An optional daily spend cap blocks any budget above it.
  • Every change is logged (get_change_log).
  • Sign-in is Facebook OAuth. TalkToAds never sees your password. Privacy · Terms

License

MIT. Made by IndianAppGuy.