Skip to content

signal-found/sf-mcp

Repository files navigation

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.

MCP Compatible PyPI Python 3.11+ smithery badge sf-mcp MCP server


Table of Contents

Signal Found MCP server


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


© 2025 Signal Found. All rights reserved.

About

Arm your agent with the ability to send 1000s of dm's on Reddit a day, selling while you sleep.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors