Home · Tools · sequence_status

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.

Slug
sequence_status
Cost
1 credit
Latency
<1s
Rate limit
240/min

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.