sf-mcp 0.1.2

Signal Found MCP server — connect AI agents to the world's largest Reddit outreach network

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 [e-mail] 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", "[e-mail]") — 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	[e-mail]

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. Install it, open Reddit, and your agent can start sending DMs immediately.

→ Install for Chrome

---

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: [e-mail]
• Bot network onboarding: [e-mail]

---

© 2025 Signal Found. All rights reserved.