Gorilla

CI Version License: MIT smithery badge gorilla-mcp MCP server

Stars Last commit Open issues TypeScript Node MCP SDK Built for Claude

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.