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
  • Claude Desktop
  • Claude Code (CLI)
  • Cursor
  • VS Code (GitHub Copilot)
  • Windsurf
  • Cline
  • Smithery
• 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: <your-client-id>

---

Claude Code (CLI)

claude mcp add signal-found --transport http https://mcp.signal-found.com/mcp

Or 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/mcp

---

Smithery

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-mcp

Then 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 closes

---

Available 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=stdio

---

Support

• Website: signal-found.com
• Email: admin@signal-found.com
• Bot network onboarding: admin@signal-found.com

---

© 2025 Signal Found. All rights reserved.

<!-- mcp-name: io.github.signal-found/sf-mcp -->