faxdrop_get_fax_status
Retrieve the current delivery status of a fax sent via this MCP. Poll until terminal status (completed, failed, or partial) is reached.
Instructions
Check the delivery status of a previously sent fax.
USE WHEN: polling for the outcome of a fax sent via faxdrop_send_fax. Status values: queued | sending | completed (or legacy delivered) | failed | partial.
DO NOT USE: for faxes sent outside this MCP (no provenance — server returns 404). Once status is completed (or delivered), failed, or partial, STOP polling — these are terminal.
SIDE EFFECTS: each non-cached call hits the FaxDrop API and counts toward its per-key rate limits (no monetary cost). Terminal results are cached process-wide.
POLLING STRATEGY: every ~5s for the first 2 min, then every ~30s up to 10 min. Most US faxes complete in <90s.
RETURNS: provider status object + optional _cached: true flag.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"faxId": "<faxId>"
},
"name": "faxdrop_get_fax_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| faxId | Yes | The fax ID returned by faxdrop_send_fax (e.g. fax_abc123). |