For AI agents

Distribution, as a tool call.

The Torchly MCP server lets an AI agent do what a growth team does: find the communities where a product's users already gather, estimate reach and cost against a target CPA, launch the campaign, and read per-room results. One URL, one header, five tools.

Install

Connected in one command.

Get an API key from the brand dashboard first - it's shown once and starts with tl_.

Claude Code

claude mcp add --transport http torchly https://app.torchlyhq.com/api/mcp \
  --header "Authorization: Bearer tl_YOUR_API_KEY"

Cursor / any MCP client (mcp.json)

{
  "mcpServers": {
    "torchly": {
      "url": "https://app.torchlyhq.com/api/mcp",
      "headers": { "Authorization": "Bearer tl_YOUR_API_KEY" }
    }
  }
}

Claude Desktop: Settings → Connectors → add a custom connector with the same URL and header. The server is registered in the official MCP registry as com.torchlyhq/torchly.

The tools

Five tools, the whole loop.

ToolWhat it does
torchly_find_communitiesFind private communities matching an audience description, filtered by platform and size. Returns brand-safe profiles with member counts and match scores.
torchly_estimate_campaignEstimate reach, clicks, conversions and cost-per-action for a campaign before committing budget.
torchly_create_campaignCreate a distribution campaign from a brief: goal, audience, platforms, budget, promo code - with optional auto-matching to the best-fit communities (admins still approve).
torchly_get_testersRecruit beta testers through community pools whose admins approve the beta brief.
torchly_get_campaign_statusLive status and per-community attribution - clicks, confirmed conversions, CPA per room.
Try it

Prompts that do real work.

Scout

“Find communities of fintech-curious professionals in the UK, minimum 1,000 members, and show me match scores.”

Price

“Estimate reach and CPA for my campaign – I’ll pay up to $20 per signup and want at most 200.”

Launch & read

“Create the campaign with auto-match on, then check which communities are converting best each morning.”

Why this exists: distribution for AI startups · what it costs: pricing.

FAQ

Agents, keys and guardrails.

A remote Model Context Protocol server at https://app.torchlyhq.com/api/mcp (streamable HTTP). It exposes Torchly's marketplace to AI agents: five tools covering community search, campaign estimation, campaign creation, beta-tester recruitment and live attribution.

With a Torchly API key as a bearer token. Create one in the brand dashboard under API keys (app.torchlyhq.com/brand/api-keys) - the key is shown once, starts with tl_, and scopes every call to your own brand's campaigns.

No. Creating a campaign via MCP creates a brief - matching, admin approvals and payment still happen through the normal flow, and nothing bills until you fund the campaign. Every community placement additionally requires that room's admin to approve the exact copy and price.

Anything speaking MCP over streamable HTTP: Claude Code, Claude Desktop (custom connector), Cursor, Windsurf, and agent frameworks with MCP support. Configuration is one URL plus one header.

Yes - the MCP server wraps the same key-authenticated REST API, so anything the tools do you can also do with plain HTTP calls. The MCP layer exists so agents can do it without custom integration.

Connect

Give your agent a distribution budget.

One URL, one header, five toolsAdmins still approve every placementNothing bills until you fund a campaign
Get an API key