sf-mcp
Arm your agent with the ability to send 1000s of dm's on Reddit a day, selling while you sleep.
Documentation
Signal Found MCP
The only AI tool that connects directly to a proprietary Reddit outreach network — find your prospects, personalize your pitch, and send thousands of DMs per day.
Table of Contents
- What is Signal Found?
- Two Ways to Operate
- Quick Setup
- Local Install (Alternative)
- How It Works
- Available Tools
- Pricing & Credits
- Chrome Extension
- Configuration Reference
- Support
What is Signal Found?
Signal Found is a Reddit-native outreach platform. You describe your product, we find people on Reddit already asking for it, and your AI agent handles the rest — messaging prospects, tracking replies, and optimizing your funnel in real time.
This MCP server gives Claude, Cursor, VS Code Copilot, Windsurf, and any other MCP-compatible AI agent direct access to the Signal Found platform. Your agent can:
- Set up your product and targeting strategy (subreddits, keywords, positioning)
- Find prospects already posting about problems your product solves
- Send personalized DMs at scale — hundreds or thousands per day
- Manage your CRM — track replies, update conversion states, follow up
- Analyze performance — close rates, voice-of-customer reports, campaign health
No custom code. No API wrangling. Just tell your agent what you're selling.
Two Ways to Operate
DIY — Your Reddit Account
Use the Signal Found Chrome Extension to link your own Reddit account. You control the account; Signal Found handles finding and messaging prospects.
**→ Install the Chrome Extension**
Managed Bot Network — Scale to Thousands
Don't want to use your own account? We operate a private network of hundreds of Reddit accounts that send outreach on your behalf — fully managed, with volume that a single account simply can't reach.
**Contact admin@signal-found.com to get onboarded.**
Quick Setup
Easiest: use our hosted server — nothing to install.
> No account yet? Leave `ONBOARD_API_CLIENT_ID` blank and ask your AI agent to run `create_new_account("Your Company", "you@example.com")` — it will sign you up and authenticate the session automatically.
Get your `client_id` at signal-found.com, then pick your client below.
Claude Desktop
Edit `claude_desktop_config.json`:
- Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
{
"mcpServers": {
"signal-found": {
"url": "https://mcp.signal-found.com/mcp"
}
}
}Restart Claude Desktop, then tell it: `Login to Signal Found with client ID: `
Claude Code (CLI)
claude mcp add signal-found --transport http https://mcp.signal-found.com/mcpOr add to `.mcp.json` in your project:
{
"mcpServers": {
"signal-found": {
"type": "http",
"url": "https://mcp.signal-found.com/mcp"
}
}
}Cursor
Add to `.cursor/mcp.json` in your project (or `~/.cursor/mcp.json` globally):
{
"mcpServers": {
"signal-found": {
"url": "https://mcp.signal-found.com/mcp"
}
}
}VS Code (GitHub Copilot)
Add to `.vscode/mcp.json` in your project:
{
"servers": {
"signal-found": {
"type": "http",
"url": "https://mcp.signal-found.com/mcp"
}
}
}Or add via the VS Code command palette: `MCP: Add Server` → HTTP → paste `https://mcp.signal-found.com/mcp`
Windsurf
Edit `~/.codeium/windsurf/mcp_config.json`:
{
"mcpServers": {
"signal-found": {
"serverUrl": "https://mcp.signal-found.com/mcp"
}
}
}Cline (VS Code Extension)
Open Cline settings → MCP Servers → Add Server → paste:
https://mcp.signal-found.com/mcpSmithery
One-click install at **smithery.ai/servers/signal-found/reddit-outreach** — Smithery will prompt you for your `client_id` and handle the rest.
Local Install (Alternative)
If you prefer to run the server locally rather than use the hosted deployment:
pip install sf-mcp
# or: uvx sf-mcpThen use this config in any client above, replacing the `url` approach:
Claude Desktop:
{
"mcpServers": {
"signal-found": {
"command": "uvx",
"args": ["sf-mcp"],
"env": {
"ONBOARD_API_CLIENT_ID": "your-client-id-here"
}
}
}
}Cursor / VS Code / Windsurf:
{
"mcpServers": {
"signal-found": {
"command": "uvx",
"args": ["sf-mcp"],
"env": {
"ONBOARD_API_CLIENT_ID": "your-client-id-here"
}
}
}
}How It Works
You describe your product
↓
Signal Found scans Reddit for people posting about
problems your product solves
↓
Your agent configures targeting (subreddits, keywords,
market positioning, conversion notes)
↓
Messages sent via your Chrome extension or
our managed account network
↓
Replies land in your Signal Found CRM
Your agent tracks them, follows up, and closesAvailable Tools
Onboarding & Setup
| Tool | Description |
|---|---|
| `login_with_client_id` | Authenticate your session, check credit balance |
| `agent_quickstart` | Recommended agent workflow for zero-context onboarding |
| `create_new_account` | Create a new Signal Found client account |
| `create_new_product` | Register a product and start the onboarding flow |
| `get_onboarding_status` | Check onboarding completion for a product |
| `run_full_agentic_onboarding` | Let the agent run the full onboarding pipeline autonomously |
Targeting & Strategy
| Tool | Description |
|---|---|
| `configure_targeting` | Set subreddits and keywords for a product |
| `configure_product_strategy` | Define market positioning and messaging strategy |
| `modify_subreddits` | Add or remove subreddits from targeting |
| `modify_keywords` | Add or remove keywords from targeting |
| `modify_market_positioning` | Update product positioning copy |
| `submit_agent_targeting` | Submit finalized targeting for campaign activation |
Outreach & Messaging
| Tool | Description |
|---|---|
| `send_reddit_message` | Send DMs to prospects (cold, reply, or batch) |
| `onboarding_campaign_decision` | Approve or modify the agent's targeting recommendations |
CRM & Pipeline
| Tool | Description |
|---|---|
| `crm_workbench` | Full CRM view — leads, conversations, states |
| `crm_customers_by_state` | Filter leads by conversion state |
| `crm_state_stats` | Conversion funnel stats |
| `change_crm_state` | Update a lead's conversion state |
| `get_conversation_by_id` | Fetch a specific conversation |
| `get_conversation_notes` | Get notes on a conversation |
| `modify_conversion_notes` | Update conversion/followup notes |
| `upsert_conversation_note` | Add or update a note on a conversation |
Analytics & Reporting
| Tool | Description |
|---|---|
| `sales_control_tower` | Command-center summary: products, campaigns, close rate, recommendations |
| `portfolio_close_rate` | Aggregate close rate across all products |
| `voice_of_customer_report` | Synthesized report from real prospect responses |
| `compare_confirmed_vs_uninterested` | Side-by-side analysis to improve targeting |
| `get_deduped_crm_by_category` | Deduplicated lead list by category |
Campaigns & Funnels
| Tool | Description |
|---|---|
| `list_campaigns` | List all campaigns and their health |
| `list_products` | List all products |
| `get_product_tree` | Full product + campaign hierarchy |
| `rebalance_resources_to_product` | Shift outreach capacity to best-performing product |
| `modify_funnels` | Adjust funnel configuration |
Billing & Credits
| Tool | Description |
|---|---|
| `billing_and_credits` | Credit balance, history, and Stripe checkout URL generation |
Pricing & Credits
Credits are consumed when Signal Found generates and sends outreach messages. One credit ≈ one message.
| Plan | Credits | Price |
|---|---|---|
| Starter | 1,000 credits | Buy via `billing_and_credits` tool |
| Pro | 7,000 credits | Buy via `billing_and_credits` tool |
| Bot Network | Unlimited | admin@signal-found.com |
When you run out of credits, any outreach tool will automatically provide direct Stripe checkout links — no need to leave your AI client.
Chrome Extension
The Signal Found Chrome Extension connects your Reddit account to the platform.
1. **Install for Chrome**
2. Open Reddit and make sure you're logged into the account you want to use
3. Ask your agent to run `register_reddit_account(reddit_username)` to register it with Signal Found
Your account is now live — the agent can use it to send DMs.
Configuration Reference
For local installs, copy `.env.example` to `.env`:
# Your client ID from signal-found.com
ONBOARD_API_CLIENT_ID=your-client-id-here
# Request timeout (seconds)
ONBOARD_API_TIMEOUT_SECONDS=60
# Transport: stdio for local, streamable-http for hosted
MCP_TRANSPORT=stdioSupport
- Website: signal-found.com
- Email: admin@signal-found.com
- Bot network onboarding: admin@signal-found.com
© 2025 Signal Found. All rights reserved.
Frequently asked questions
What is sf-mcp?
sf-mcp is Arm your agent with the ability to send 1000s of dm's on Reddit a day, selling while you sleep.
How do I install sf-mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is sf-mcp open source?
Yes — it is hosted on GitHub at https://github.com/signal-found/sf-mcp and has 3 stars.
Related MCP tools
Cognee is the open-source AI memory platform for agents. Give your AI agents persistent long-term memory across sessions with a self-hosted knowledge graph engine.
Automate browser based workflows with AI
Hindsight: Agent Memory That Learns
A privacy-first app that strips AI watermarks from content you own.
Agent framework and applications built upon Qwen>=3.0, featuring Function Calling, MCP, Code Interpreter, RAG, Chrome extension, etc.
The power of Claude Code / GeminiCLI / CodexCLI + [Gemini / OpenAI / OpenRouter / Azure / Grok / Ollama / Custom Model / All Of The Above] working as one.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP