{
  "markdown": "# Signal Found MCP\n\n**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.**\n\n[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)\n[![PyPI](https://img.shields.io/pypi/v/sf-mcp)](https://pypi.org/project/sf-mcp/)\n[![Python 3.11+](https://img.shields.io/badge/Python-3.11%2B-green)](https://python.org)\n[![smithery badge](https://smithery.ai/badge/signal-found/reddit-outreach)](https://smithery.ai/servers/signal-found/reddit-outreach)\n[![sf-mcp MCP server](https://glama.ai/mcp/servers/signal-found/sf-mcp/badges/score.svg)](https://glama.ai/mcp/servers/signal-found/sf-mcp)\n\n---\n\n## Table of Contents\n\n- [What is Signal Found?](#what-is-signal-found)\n- [Two Ways to Operate](#two-ways-to-operate)\n- [Quick Setup](#quick-setup)\n  - [Claude Desktop](#claude-desktop)\n  - [Claude Code (CLI)](#claude-code-cli)\n  - [Cursor](#cursor)\n  - [VS Code (GitHub Copilot)](#vs-code-github-copilot)\n  - [Windsurf](#windsurf)\n  - [Cline](#cline-vs-code-extension)\n  - [Smithery](#smithery)\n- [Local Install (Alternative)](#local-install-alternative)\n- [How It Works](#how-it-works)\n- [Available Tools](#available-tools)\n- [Pricing & Credits](#pricing--credits)\n- [Chrome Extension](#chrome-extension)\n- [Configuration Reference](#configuration-reference)\n- [Support](#support)\n\n[![Signal Found MCP server](https://glama.ai/mcp/servers/signal-found/sf-mcp/badges/card.svg)](https://glama.ai/mcp/servers/signal-found/sf-mcp)\n\n---\n\n## What is Signal Found?\n\nSignal 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.\n\nThis 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:\n\n- **Set up your product** and targeting strategy (subreddits, keywords, positioning)\n- **Find prospects** already posting about problems your product solves\n- **Send personalized DMs** at scale — hundreds or thousands per day\n- **Manage your CRM** — track replies, update conversion states, follow up\n- **Analyze performance** — close rates, voice-of-customer reports, campaign health\n\nNo custom code. No API wrangling. Just tell your agent what you're selling.\n\n---\n\n## Two Ways to Operate\n\n### DIY — Your Reddit Account\nUse the **Signal Found Chrome Extension** to link your own Reddit account. You control the account; Signal Found handles finding and messaging prospects.\n\n**[→ Install the Chrome Extension](https://onboard.signal-found.com/extensions/reddit)**\n\n### Managed Bot Network — Scale to Thousands\nDon'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.\n\n**Contact [admin@signal-found.com](mailto:admin@signal-found.com) to get onboarded.**\n\n---\n\n## Quick Setup\n\n**Easiest: use our hosted server — nothing to install.**\n\n> **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.\n\nGet your `client_id` at [signal-found.com](https://signal-found.com), then pick your client below.\n\n---\n\n### Claude Desktop\n\nEdit `claude_desktop_config.json`:\n- **Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"signal-found\": {\n      \"url\": \"https://mcp.signal-found.com/mcp\"\n    }\n  }\n}\n```\n\nRestart Claude Desktop, then tell it: `Login to Signal Found with client ID: <your-client-id>`\n\n---\n\n### Claude Code (CLI)\n\n```bash\nclaude mcp add signal-found --transport http https://mcp.signal-found.com/mcp\n```\n\nOr add to `.mcp.json` in your project:\n\n```json\n{\n  \"mcpServers\": {\n    \"signal-found\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.signal-found.com/mcp\"\n    }\n  }\n}\n```\n\n---\n\n### Cursor\n\nAdd to `.cursor/mcp.json` in your project (or `~/.cursor/mcp.json` globally):\n\n```json\n{\n  \"mcpServers\": {\n    \"signal-found\": {\n      \"url\": \"https://mcp.signal-found.com/mcp\"\n    }\n  }\n}\n```\n\n---\n\n### VS Code (GitHub Copilot)\n\nAdd to `.vscode/mcp.json` in your project:\n\n```json\n{\n  \"servers\": {\n    \"signal-found\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.signal-found.com/mcp\"\n    }\n  }\n}\n```\n\nOr add via the VS Code command palette: `MCP: Add Server` → HTTP → paste `https://mcp.signal-found.com/mcp`\n\n---\n\n### Windsurf\n\nEdit `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"signal-found\": {\n      \"serverUrl\": \"https://mcp.signal-found.com/mcp\"\n    }\n  }\n}\n```\n\n---\n\n### Cline (VS Code Extension)\n\nOpen Cline settings → MCP Servers → Add Server → paste:\n\n```\nhttps://mcp.signal-found.com/mcp\n```\n\n---\n\n### Smithery\n\nOne-click install at **[smithery.ai/servers/signal-found/reddit-outreach](https://smithery.ai/servers/signal-found/reddit-outreach)** — Smithery will prompt you for your `client_id` and handle the rest.\n\n---\n\n## Local Install (Alternative)\n\nIf you prefer to run the server locally rather than use the hosted deployment:\n\n```bash\npip install sf-mcp\n# or: uvx sf-mcp\n```\n\nThen use this config in any client above, replacing the `url` approach:\n\n**Claude Desktop:**\n```json\n{\n  \"mcpServers\": {\n    \"signal-found\": {\n      \"command\": \"uvx\",\n      \"args\": [\"sf-mcp\"],\n      \"env\": {\n        \"ONBOARD_API_CLIENT_ID\": \"your-client-id-here\"\n      }\n    }\n  }\n}\n```\n\n**Cursor / VS Code / Windsurf:**\n```json\n{\n  \"mcpServers\": {\n    \"signal-found\": {\n      \"command\": \"uvx\",\n      \"args\": [\"sf-mcp\"],\n      \"env\": {\n        \"ONBOARD_API_CLIENT_ID\": \"your-client-id-here\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## How It Works\n\n```\nYou describe your product\n        ↓\nSignal Found scans Reddit for people posting about\nproblems your product solves\n        ↓\nYour agent configures targeting (subreddits, keywords,\nmarket positioning, conversion notes)\n        ↓\nMessages sent via your Chrome extension or\nour managed account network\n        ↓\nReplies land in your Signal Found CRM\nYour agent tracks them, follows up, and closes\n```\n\n---\n\n## Available Tools\n\n### Onboarding & Setup\n| Tool | Description |\n|------|-------------|\n| `login_with_client_id` | Authenticate your session, check credit balance |\n| `agent_quickstart` | Recommended agent workflow for zero-context onboarding |\n| `create_new_account` | Create a new Signal Found client account |\n| `create_new_product` | Register a product and start the onboarding flow |\n| `get_onboarding_status` | Check onboarding completion for a product |\n| `run_full_agentic_onboarding` | Let the agent run the full onboarding pipeline autonomously |\n\n### Targeting & Strategy\n| Tool | Description |\n|------|-------------|\n| `configure_targeting` | Set subreddits and keywords for a product |\n| `configure_product_strategy` | Define market positioning and messaging strategy |\n| `modify_subreddits` | Add or remove subreddits from targeting |\n| `modify_keywords` | Add or remove keywords from targeting |\n| `modify_market_positioning` | Update product positioning copy |\n| `submit_agent_targeting` | Submit finalized targeting for campaign activation |\n\n### Outreach & Messaging\n| Tool | Description |\n|------|-------------|\n| `send_reddit_message` | Send DMs to prospects (cold, reply, or batch) |\n| `onboarding_campaign_decision` | Approve or modify the agent's targeting recommendations |\n\n### CRM & Pipeline\n| Tool | Description |\n|------|-------------|\n| `crm_workbench` | Full CRM view — leads, conversations, states |\n| `crm_customers_by_state` | Filter leads by conversion state |\n| `crm_state_stats` | Conversion funnel stats |\n| `change_crm_state` | Update a lead's conversion state |\n| `get_conversation_by_id` | Fetch a specific conversation |\n| `get_conversation_notes` | Get notes on a conversation |\n| `modify_conversion_notes` | Update conversion/followup notes |\n| `upsert_conversation_note` | Add or update a note on a conversation |\n\n### Analytics & Reporting\n| Tool | Description |\n|------|-------------|\n| `sales_control_tower` | Command-center summary: products, campaigns, close rate, recommendations |\n| `portfolio_close_rate` | Aggregate close rate across all products |\n| `voice_of_customer_report` | Synthesized report from real prospect responses |\n| `compare_confirmed_vs_uninterested` | Side-by-side analysis to improve targeting |\n| `get_deduped_crm_by_category` | Deduplicated lead list by category |\n\n### Campaigns & Funnels\n| Tool | Description |\n|------|-------------|\n| `list_campaigns` | List all campaigns and their health |\n| `list_products` | List all products |\n| `get_product_tree` | Full product + campaign hierarchy |\n| `rebalance_resources_to_product` | Shift outreach capacity to best-performing product |\n| `modify_funnels` | Adjust funnel configuration |\n\n### Billing & Credits\n| Tool | Description |\n|------|-------------|\n| `billing_and_credits` | Credit balance, history, and Stripe checkout URL generation |\n\n---\n\n## Pricing & Credits\n\nCredits are consumed when Signal Found generates and sends outreach messages. One credit ≈ one message.\n\n| Plan | Credits | Price |\n|------|---------|-------|\n| **Starter** | 1,000 credits | Buy via `billing_and_credits` tool |\n| **Pro** | 7,000 credits | Buy via `billing_and_credits` tool |\n| **Bot Network** | Unlimited | [admin@signal-found.com](mailto:admin@signal-found.com) |\n\nWhen you run out of credits, any outreach tool will automatically provide direct Stripe checkout links — no need to leave your AI client.\n\n---\n\n## Chrome Extension\n\nThe Signal Found Chrome Extension connects your Reddit account to the platform.\n\n1. **[Install for Chrome](https://onboard.signal-found.com/extensions/reddit)**\n2. Open Reddit and make sure you're logged into the account you want to use\n3. Ask your agent to run `register_reddit_account(reddit_username)` to register it with Signal Found\n\nYour account is now live — the agent can use it to send DMs.\n\n---\n\n## Configuration Reference\n\nFor local installs, copy `.env.example` to `.env`:\n\n```env\n# Your client ID from signal-found.com\nONBOARD_API_CLIENT_ID=your-client-id-here\n\n# Request timeout (seconds)\nONBOARD_API_TIMEOUT_SECONDS=60\n\n# Transport: stdio for local, streamable-http for hosted\nMCP_TRANSPORT=stdio\n```\n\n---\n\n## Support\n\n- **Website:** [signal-found.com](https://signal-found.com)\n- **Email:** [admin@signal-found.com](mailto:admin@signal-found.com)\n- **Bot network onboarding:** [admin@signal-found.com](mailto:admin@signal-found.com)\n\n---\n\n© 2025 Signal Found. All rights reserved.\n\n<!-- mcp-name: io.github.signal-found/sf-mcp -->\n\n",
  "bytes": 10895,
  "sha": "4368142d0fb27deaa70fc7cf005b6c326f8ed64847cc0cfd509afa7d3318c455",
  "repo_slug": "signal-found/sf-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_signal_found_sf_mcp_c994bf40/readme"
}