Gorilla MCP

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.