sequence_statusLive counters for an in-flight job.
Once a sequence is dispatched, the agent needs to know what's happening. sequence_status returns per-step delivery, opens, replies, opt-outs and any send errors for a given job. One credit. Sub-second. Drop into a daily standup post or a Slack hourly check-in.
When to call this tool
Use it on a schedule for active jobs and on demand when a stakeholder asks "is the campaign working?". The status object is granular enough to drive automation — for example, automatically pausing a sequence whose reply-rate drops below a floor, or escalating a thread once a positive reply lands.
Input schema
{ "job_id": "…" }
Output schema
{ "job_id": "…", "steps": [{ "day", "sent", "opened", "replied", "opt_out", "errors" }], "summary": { "reply_rate", "open_rate" }, "credits_used": 1 }
Example invocations
1. Claude Desktop
How is job_zk9 doing? Pause if reply_rate < 4%.
2. ChatGPT custom GPT
For "campaign status" prompts, call sequence_status and lead with summary, then top 3 errors if any.
3. Cursor MCP
Build a CLI: foxapis status <job_id>.
4. n8n
{ "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "sequence_status", "arguments": { "job_id": "job_zk9" } } }
5. Raw curl
curl -X POST https://www.mentionfox.com/mcp \ -H "Authorization: Bearer $FOXAPIS_KEY" \ -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"sequence_status","arguments":{"job_id":"job_zk9"}}}'
Sample output
{ "job_id": "job_zk9", "summary": { "open_rate": 42, "reply_rate": 7.1 }, "steps": [{ "day": 0, "sent": 100, "opened": 38, "replied": 5, "opt_out": 1, "errors": 0 }], "credits_used": 1 }
Credit cost & rate limits
1 credit per call. 240 per minute.
Error codes & recovery
404 NO_JOBJob id doesn't exist.410 EXPIREDJob older than 180 days; counters archived.