# opusforge/gorilla-mcp [Health: Active]

**Category:** 🎯 Marketing  
**Repository:** https://github.com/opusforge/gorilla-mcp  
**GitHub Stars:** 3  
**npm Downloads (last month):** 73  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/opusforge-gorilla-mcp

## Description
Lead discovery for solo SaaS founders. Searches Reddit, X, YouTube, and TikTok for posts where people describe a problem your product solves, ranks each by buying intent, and returns ranked leads. Includes findleads, draftoutreach, and planacquisitionfunnel for the full acquisition flow. Hosted, $0.99 per run. Install: npx -y github:opusforge/gorilla-mcp. Sign up: usegorilla.app.

## Tools
Capabilities this server exposes over MCP:

- **search** — Search Reddit, X, YouTube, LinkedIn, and Bluesky in parallel for posts where people express demand for what you describe. Returns results ranked Hot / Warm / Cold by buying intent. Takes 30-90 seconds. One credit per qualified lead (Hot or Warm); Cold results are free, and a failed search is refund…
- **get_search** — Fetch the current state and results for a search by its `search_id`. Use it to recover a search that timed out client-side, or to re-read a recent one. Free.
- **billing_status** — Check your plan and remaining credit balance. Free.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "gorilla-mcp": {
    "command": "npx",
    "args": ["-y","@usegorilla/mcp"],
    "env": {
      "GORILLA_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `GORILLA_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What opusforge/gorilla-mcp MCP server does

opusforge/gorilla-mcp MCP server connects an MCP client to Gorilla's lead-discovery service. It searches public posts across Reddit, X, YouTube, LinkedIn, and Bluesky for people expressing a need related to a product description. Results include the source, channel, title, URL, score, and a Hot, Warm, or Cold buying-intent classification.

The service is aimed at solo SaaS founders and other developers researching potential early users. It can help identify conversations that describe a problem a product may solve, rather than limiting research to a single social network.

## How it works

The `search` tool accepts a plain-language `query`. Optional parameters select a source, time range, and result limit. The available source values are Reddit, Twitter, YouTube, LinkedIn, Bluesky, or all sources. The default time range is seven days, and the default maximum is 50 results; the limit can range from 1 to 200. Searches generally take 30 to 90 seconds.

Each search returns a `search_id`, scored results, and the credits charged. Hot and Warm results consume one credit per qualified lead, while Cold results do not consume credits. Failed searches are refunded. The free tier includes Reddit, X, YouTube, and Bluesky; LinkedIn requires the paid plan.

Use `get_search` with a search ID to retrieve the current state and results of a search. This is useful when an MCP client times out before the remote search finishes or when recent results need to be read again. `billing_status` reports the current plan and remaining credit balance, and neither of these tools consumes credits.

## Setup and configuration

The package can run through `npx` using the published `@usegorilla/mcp` package. Configure the `GORILLA_API_KEY` environment variable with a key created in the Gorilla platform. The key is obtained by signing up at usegorilla.app, opening the platform dashboard, and creating an API key from the API Keys menu.

A local MCP configuration uses `npx`, the `-y` flag, and `@usegorilla/mcp`. The README provides configuration examples for Claude Code and Cursor. Node.js 22.x is listed by the project. No additional configuration is required for the public API. `GORILLA_API_BASE` can optionally override the default API base URL, `https://usegorilla.app/v1`, including for self-hosted deployments.

## Tools and capabilities

- `search`: Search supported platforms in parallel and rank matching posts by buying intent.
- `get_search`: Retrieve the state and results associated with a `search_id`.
- `billing_status`: View the plan and available credits.

opusforge/gorilla-mcp MCP server is distributed under the MIT license. The repository also documents installation through Smithery, which provides an MCPB bundle for compatible clients.

## Limitations and notes

The free allowance is a one-time 100-credit trial with no card required. The documented paid plan costs $14.99 per month and includes 2,000 credits, with unused credits rolling over. Searches can consume multiple credits when they return multiple Hot or Warm leads, while `get_search` and `billing_status` are free.

The server requires a Gorilla API key and depends on Gorilla's hosted API unless `GORILLA_API_BASE` is changed. LinkedIn is not included in the free source set. Search duration can reach 90 seconds, so clients should use `get_search` to recover results after a client-side timeout.

_Full upstream README: https://allmcps.com/mcp/opusforge-gorilla-mcp/readme_