MCP Server

Engaggit can expose its Reddit search capabilities through a local Model Context Protocol (MCP) server. This lets any MCP-compatible client (Claude Desktop, Cursor, and other AI assistants) query Reddit using Engaggit's data.

The server is disabled by default. Enable it only when needed.

Enabling the Server

1. Open Settings, then the MCP Server tab, or click the MCP button in the app header.
2. Click Start server.
3. The server starts listening on http://127.0.0.1:4350/mcp by default.

Once running, the header's MCP button shows a green indicator. You can start and stop the server from the settings window at any time.

Configuration

Setting	Default	Description
Host	127.0.0.1	Network interface the server binds to
Port	4350	TCP port the MCP server listens on
Auto-start on app launch	Off	Start the server automatically when Engaggit launches

WARNING

Keep the default 127.0.0.1 host. The server has no authentication — binding to 0.0.0.0 would expose it to your entire network.

Connecting an MCP Client

Select the Streamable HTTP transport (sometimes labeled "HTTP" or "Remote") in your MCP client and use this endpoint URL:

http://127.0.0.1:4350/mcp

Make sure the MCP server is running in Engaggit before connecting.

Configuring MCP Clients

Claude Desktop

Add the server to your Claude Desktop configuration (claude_desktop_config.json) and restart Claude:

{
  "mcpServers": {
    "engaggit": {
      "type": "http",
      "url": "http://127.0.0.1:4350/mcp"
    }
  }
}

Cursor

Create .cursor/mcp.json in your project root (or ~/.cursor/mcp.json to make it available globally):

{
  "mcpServers": {
    "engaggit": {
      "url": "http://127.0.0.1:4350/mcp"
    }
  }
}

Cursor discovers remote HTTP (Streamable HTTP) servers by their url automatically. Restart Cursor or reload the window to pick up the new server, then enable it from Customize in the sidebar.

OpenCode

Add the server to opencode.json in your project root (or your global OpenCode config):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "engaggit": {
      "type": "remote",
      "url": "http://127.0.0.1:4350/mcp"
    }
  }
}

The Engaggit tools then appear as engaggit-reddit tools (e.g. engaggit-reddit_search-reddit) alongside OpenCode's built-in tools. Restart OpenCode after editing the config.

Available Tools

search-reddit

Search Reddit for posts matching a query. Returns titles, URLs, scores, subreddits, and post bodies.

Parameter	Type	Description
query	string	Search query string
subreddit	string	Optional — search within a specific subreddit (without r/ prefix)
timeRange	string	Optional — hour, day, week, month, year, or all. Default: day
limit	number	Optional — max results to return (1–25). Default: 10

get-post-content

Get the full content of a Reddit post by URL.

Parameter	Type	Description
url	string	Full Reddit post URL, e.g. https://www.reddit.com/r/subreddit/comments/abc123/title/

Returns the post's author, score, upvote ratio, comment count, flair, body, and more.

Reddit Credentials

Search results come from Reddit's API. For the most reliable access, configure your Reddit API credentials in Engaggit first. The MCP server reuses those credentials automatically — no separate setup is needed.