sf-mcp

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: ``json { "mcpServers": { "signal-found": { "command": "uvx", "args": ["sf-mcp"], "env": { "ONBOARD_API_CLIENT_ID": "your-client-id-here" } } } } ``

Cursor / VS Code / Windsurf: ``json { "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 -->