Firecrawl Agent Status
firecrawl_agent_statusCheck the status of an agent job and retrieve results when complete.
How it works ↓Pricing
Per call
$0.03
Model
flat
Pay only for what you use. No subscriptions.
Inputs
id *
stringInput Parameters
Cost per run
Execution cost$0.03
About Firecrawl Agent Status
Check the status of an agent job and retrieve results when complete. Use this to poll for results after starting an agent with firecrawl_agent.
IMPORTANT - Be patient with polling:
- Poll every 15-30 seconds
- Keep polling for at least 2-3 minutes before considering the request failed
- Complex research can take 5+ minutes - do not give up early
- Only stop polling when status is "completed" or "failed"
Usage Example:
{
"name": "firecrawl_agent_status",
"arguments": {
"id": "550e8400-e29b-41d4-a716-446655440000"
}
}
Possible statuses:
- processing: Agent is still researching - keep polling, do not give up
- completed: Research finished - response includes the extracted data
- failed: An error occurred (only stop polling on this status)
Returns: Status, progress, and results (if completed) of the agent job.
Frequently Asked Questions
Check the status of an agent job and retrieve results when complete. Use this to poll for results after starting an agent with `firecrawl_agent`. **IMPORTANT - Be patient with polling:** - Poll every 15-30 seconds - **Keep polling for at least 2-3 minutes** before considering the request failed - Complex research can take 5+ minutes - do not give up early - Only stop polling when status is "completed" or "failed" **Usage Example:** ```json { "name": "firecrawl_agent_status", "arguments": { "id": "550e8400-e29b-41d4-a716-446655440000" } } ``` **Possible statuses:** - processing: Agent is still researching - keep polling, do not give up - completed: Research finished - response includes the extracted data - failed: An error occurred (only stop polling on this status) **Returns:** Status, progress, and results (if completed) of the agent job.
Firecrawl Agent Status costs $0.03 per call on xpay. No subscription, no minimums. Pay only for the calls you make. New accounts get $5 in free credits.
Connect the Firecrawl MCP endpoint to your client — Claude Code: claude mcp add --transport http firecrawl "https://firecrawl.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"; Cursor/Windsurf/Cline/VS Code: same URL in mcp.json. The agent will see firecrawl_agent_status as a callable tool with the input schema and run it directly. (Unified across all providers: https://mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY, then xpay_run with toolPath firecrawl/firecrawl_agent_status.)
Yes — that's exactly what xpay is for. You don't need a Firecrawl account or API key. Sign up at xpay.tools (Google or email), get $5 free credit, and run Firecrawl Agent Status immediately. Billing flows through your xpay balance.
Firecrawl Agent Status accepts 1 input parameter: id. See the input schema and runnable form on this page for details and to test live.