Gorilla MCP Server

Model Context Protocol server for Gorilla. Find your first 100 SaaS users by searching Reddit, X, YouTube, TikTok, LinkedIn, and Threads for real demand signals. Every $5 run hits all six platforms.

Learn more: usegorilla.app · Real run examples · How Gorilla compares · Blog

Setup

Run directly from GitHub with npx:

GORILLA_API_KEY=grla_... npx -y github:opusforge/gorilla-mcp

Or clone and run locally:

git clone https://github.com/opusforge/gorilla-mcp
cd gorilla-mcp
npm install && npm run build
GORILLA_API_KEY=grla_... node dist/index.js

Get your API key

1. Sign up at usegorilla.app. $5 per run, no subscription.

2. Sign in at platform.usegorilla.app.

3. Menu, API Keys, Create.

4. Copy the key (shown once).

Configure in Claude Code

Add to your Claude Code settings:

{
  "mcpServers": {
    "gorilla": {
      "command": "npx",
      "args": ["-y", "github:opusforge/gorilla-mcp"],
      "env": {
        "GORILLA_API_KEY": "grla_your_key_here"
      }
    }
  }
}

Configure in Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "gorilla": {
      "command": "npx",
      "args": ["-y", "github:opusforge/gorilla-mcp"],
      "env": {
        "GORILLA_API_KEY": "grla_your_key_here"
      }
    }
  }
}

Related MCP server: Bluesky Social MCP

Tools

Tools are namespaced by domain (leads.*, idea.*, runs.*, outreach.*, account.*).

leads.find

Run the full pipeline. Searches Reddit, X, YouTube, TikTok, LinkedIn, and Threads and returns scored leads. All six platforms hit on every $5 run. Takes 60-120 seconds. Costs 1 run credit.

Parameters: idea (required) — product description

Returns: Scored leads with source, channel, title, URL, lead_score (0-1), and outreach hints.

idea.refine

Conversational refinement. Returns one clarifying question at a time to sharpen the idea before searching. Free.

Parameters: idea (required), plus current_refined_idea, history, language, turn, max_turns (all optional)

Returns: Status, refined_idea, readiness_score, and the next question (or null when ready).

idea.expand

Generate keyword scaffolding (core keywords, adjacent niches, pain points, competitor names, exclusion terms) without running searches. Costs 1 run credit.

Parameters: idea (required)

Returns: Structured themes for targeted searches.

leads.search

Search a single platform with custom queries. Bypasses theme expansion and AI scoring. Costs 1 run credit.

Parameters:

• source (required): reddit, x, youtube, tiktok, or linkedin (LinkedIn is Pro-only)

• queries (required): Array of search queries

• run_id (optional): Attach results to an existing run

Returns: Raw leads from the specified platform.

runs.get

Fetch results for a previously-started run. Free.

Parameters: run_id (required)

runs.list

List your last 50 runs, newest first. Free.

account.billing

Check your plan, remaining weekly runs, and referral credits. Free.

Returns: Plan name, weekly usage, referral credits, total available runs.

outreach.draft

Generate a platform-tuned outreach message for a specific lead. Costs 1 run credit per draft.

Parameters: idea, source, outreach_action, post_title, post_body (required), plus optional post_handle, language, reply_to_author, reply_to_text.

Returns: A ready-to-paste draft.

outreach.plan

Build a Week-1 outreach plan from a completed run's HIGH-intent leads, with per-channel send cadence. Free.

Parameters: run_id (required)

Example workflow

1. idea.refine("a language learning app for travelers")
   → "Who's the target user? Daily commuters or tourists?"

2. leads.find(refined_idea)
   → 47 leads across Reddit, X, YouTube, TikTok, LinkedIn, and Threads
   → 12 high-intent (people actively searching for this)

3. outreach.plan(run_id)
   → Week-1 plan: 3/day on Reddit, 4/day on X, 3/day on Threads, 2/day on YT/TT/LinkedIn

4. outreach.draft(...)  → ready-to-send reply for each high-intent lead

Install via Smithery

Available at smithery.ai/server/opusforge/gorilla-mcp. Smithery distributes a pre-built MCPB bundle that any MCPB-compatible client can install in one click.

Environment variables

Backend URL and gateway key are fetched automatically from https://platform.usegorilla.app/mcp-config.json on startup. No other configuration required.

Pricing

• Single run: $5 flat. Pay per use, no subscription. Hits all six platforms (Reddit, X, YouTube, TikTok, LinkedIn, Threads).

leads.find, leads.search, idea.expand, and outreach.draft each cost 1 run credit. idea.refine, runs.get, runs.list, account.billing, and outreach.plan are free.

See usegorilla.app for the full product.