Gorilla MCP Server

Model Context Protocol server for Gorilla. Find your first 100 SaaS users by searching Reddit, YouTube, X, TikTok, and LinkedIn for real demand signals. (LinkedIn search requires a weekly / monthly / lifetime plan; the $0.99 one-run plan covers the other four.)

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 and pick a plan ($0.99 single run, $3.99/wk Pro, or $149.99 lifetime).
2. Sign in at gorilla.opusforge.com.br.
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"
      }
    }
  }
}

Tools

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

leads.find

Run the full pipeline. Searches Reddit, X, YouTube, TikTok, and LinkedIn and returns scored leads. (LinkedIn is gated to weekly / monthly / lifetime plans; the $0.99 one-run plan covers the other four.) 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, YouTube, X, TikTok, and LinkedIn (Pro)
   → 12 high-intent (people actively searching for this)

3. outreach.plan(run_id)
   → Week-1 plan: 3/day on Reddit, 4/day on X, 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

Variable	Required	Description
GORILLA_API_KEY	Yes	Your API key (starts with grla_)
GORILLA_DEFAULT_LANGUAGE	No	Fallback language for idea.refine and outreach.draft (en, pt, all). Default: en.
GORILLA_CONFIG_URL	No	Override the runtime config endpoint. Useful for staging or self-hosted deployments.

Backend URL and gateway key are fetched automatically from https://gorilla.opusforge.com.br/mcp-config.json on startup. No other configuration required.

Pricing

• Single run: $0.99. Pay per use, no subscription. Covers Reddit, X, YouTube, TikTok.
• Weekly Pro: $3.99/week, 5 runs. Adds LinkedIn.
• Monthly Pro: $14.99/month. Adds LinkedIn.
• Lifetime: $149.99 once, unlimited runs. Adds LinkedIn.

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 current plans and the full product.