signalmelo-mcp

Lightweight MCP server for Reddit community signals.

This server provides one tool only:

• analyze_reddit_community_signals

Output format is intentionally fixed:

• whatUsersLike
• whatUsersDontLike
• competitorsUsersMention
• sources

BYOK

This server uses your own API keys. Usage and billing are tied to your provider accounts.

Required environment variables:

• REDDIT_CLIENT_ID
• REDDIT_CLIENT_SECRET
• REDDIT_USER_AGENT
• LLM_API_KEY

Quick Start

npm install
npm run build

Create Reddit API Credentials

1. Go to Reddit app preferences.
2. Click create app (or create another app).
3. Set app type to script.
4. Fill required fields:
   • name: any app name
   • redirect uri: you can use http://localhost:3000 for this server
5. Save the app, then copy:
   • client id (under app name)
   • secret
6. Set environment variables:
   • REDDIT_CLIENT_ID=<YOUR_REDDIT_CLIENT_ID>
   • REDDIT_CLIENT_SECRET=<YOUR_REDDIT_CLIENT_SECRET>
   • REDDIT_USER_AGENT=signalmelo-mcp/0.1 by your_reddit_username

REDDIT_USER_AGENT should be descriptive and include your Reddit username.

MCP Config Example

{
  "mcpServers": {
    "signalmelo-mcp": {
      "command": "node",
      "args": ["<ABSOLUTE_PATH>/signalmelo-mcp/dist/index.js"],
      "env": {
        "REDDIT_CLIENT_ID": "<YOUR_REDDIT_CLIENT_ID>",
        "REDDIT_CLIENT_SECRET": "<YOUR_REDDIT_CLIENT_SECRET>",
        "REDDIT_USER_AGENT": "signalmelo-mcp/0.1 by your_reddit_username",
        "LLM_API_KEY": "<YOUR_LLM_API_KEY>",
      }
    }
  }
}

Tool Input

{
  "query": "notion alternative for startup teams",
  "subreddits": ["SaaS", "startups"],
  "timeRange": "30d",
  "maxPosts": 30
}

Notes

• subreddits max length: 5
• maxPosts range: 5-50
• If model summarization fails, fallback output still returns sources.
• Reddit API requires a valid app and descriptive REDDIT_USER_AGENT.
• Never commit real credentials into git. Use env vars only.