API reference
SignalPipe exposes two public surfaces: a REST API for direct integration and an MCP server for AI agents. Both are backed by the same Mantidae scout engine and require operator-key Bearer auth.
Quickstart
https://api.signalpipe.ioAuthorization: Bearer YOUR_OPERATOR_KEYREST endpoints
Direct HTTP for sidecars, dashboards, and any non-agent integration.
| Method | Path | Description |
|---|---|---|
| GET | /health | Liveness probe (no auth). |
| POST | /scout/launch_batch | Run a scout cycle. Triggered by pg_cron every 2h. |
| GET | /sync/missions | List pending missions. Supports ?status= and ?include=draft_context. |
| POST | /actions/upload_draft | Upload a draft for a mission. |
| POST | /actions/approve | Approve a mission for outreach. |
| POST | /actions/reject | Reject a mission. Feeds the RL loop. |
| POST | /actions/ack | Acknowledge a sent mission. |
| POST | /products/reload | Hot-reload the product / anchor cache. |
| POST | /stations/add | Add a new RSS station to a product. |
MCP server
Connect from Claude Code, Cursor, Windsurf, or any MCP-compatible client.
https://api.signalpipe.io/mcp/sse14 tools across 4 categories. Same operator-key Bearer auth as the REST surface — agents act with the operator’s permissions, never autonomously.
Missions — 5 tools
get_missionsFetch pending lead missions awaiting human review.draft_missionGet drafting instructions and context for a mission.upload_draftUpload a reply draft you wrote for a mission.approve_missionApprove a mission and queue it for outreach.reject_missionReject a mission with an optional reason — feeds the RL loop.
Pipeline — 4 tools
get_pipelineGet the prospect pipeline sorted hottest first.track_prospectAdd a prospect to the nurture pipeline.get_message_promptFetch the system prompt and conversation context for a prospect.record_messageRecord a message and its outcome — adjusts temperature.
Products — 4 tools
get_productsList all configured products.add_productCreate a new product with anchor sentences and keywords.add_stationAdd a new RSS / Reddit / HN station to a product.reload_productsReload the product cache after adding or editing.
Scout — 1 tool
scout_nowTrigger an on-demand scouting run across all active products.
Auth model
Every request — REST or MCP — must include the operator key as a Bearer token. The key is set as OPERATOR_KEY in the backend env and is the same value across the dashboard, sidecar, and MCP clients.
No user accounts, no per-tool scopes — SignalPipe is single-operator by design. If you need multi-tenant auth, deploy your own Mantidae instance from the schema in supabase_schema.sql.