subscribe
ActiveTool of mcp-firecrawl
Create a proactive monitoring subscription to a live-data event stream. Returns the new subscription id. Requires a Pipeworx OAuth account (anonymous + BYO cannot persist subscriptions). Supported types: "sec_8k" (8-K filings matching ticker + item codes — e.g. items:["5.02"] = officer change), "polymarket_edge" (Polymarket↔Kalshi cross-venue mispricings — params:{topic:"fed"}), "fred_series" (new FRED observations — params:{series_id:"UNRATE"}). Delivery channels: feed (always on — pull via recent_alerts or GET registry.pipeworx.io/alerts.json), and optionally email (set delivery:{email:"you@x.com"}) or sms (delivery:{sms:"+15551234567"} — phone must be verified at /account first; 10/day cap).
Parameters schema
{
"type": "object",
"required": [
"type",
"params"
],
"properties": {
"type": {
"enum": [
"sec_8k",
"polymarket_edge",
"fred_series",
"patent_grant",
"clinical_trial"
],
"type": "string",
"description": "Subscription type."
},
"params": {
"type": "object",
"description": "Type-specific filter. sec_8k: {ticker:\"AAPL\", items?:[\"5.02\",\"1.01\"]}. polymarket_edge: {topic:\"fed\", min_spread_bps?:500}. fred_series: {series_id:\"UNRATE\"}. patent_grant: {applicant:\"Apple Inc.\"}. clinical_trial: {sponsor?:\"Pfizer\", condition?:\"lung cancer\", phase?:\"PHASE3\"} (sponsor or condition required)."
},
"delivery": {
"type": "object",
"properties": {
"sms": {
"type": "string",
"description": "E.164 phone number, e.g. \"+15551234567\". Must match the account's verified phone."
},
"email": {
"type": "string",
"description": "Email address to deliver alerts to. Validated against a standard pattern."
},
"webhook": {
"type": "string",
"description": "HTTPS URL to POST fired events to. https only; localhost/private hosts rejected. Signing secret returned once at subscribe time."
}
},
"description": "Optional delivery channels in addition to the always-on persistent feed. {email:\"you@x.com\"} sends a templated alert per fired event. {sms:\"+15551234567\"} sends an SMS per event — must match the verified phone on the caller's account (verify at https://pipeworx.io/account first; 10/day cap). {webhook:\"https://...\"} POSTs each event JSON to your endpoint, HMAC-signed — the response includes delivery.webhook_secret (whsec_…) ONCE; verify X-Pipeworx-Signature = sha256 HMAC of \"<X-Pipeworx-Timestamp>.<raw body>\". Auto-disabled after 10 consecutive failing runs."
}
}
}Parent server
mcp-firecrawl
https://github.com/pipeworx-io/mcp-firecrawl
2/7 registries