get-job-status

POST /api/v1/get-job-status 0 credits/call jobs

Get the status, progress, and final result of an async job. Pass the job_id returned by an async tool (e.g. generate-image, transcribe-audio). Poll every 1-2 seconds (back off to 5-10s after 30s) until status is 'completed' (read the result field) or 'failed' / 'dead' (read error_message).

Sign in + create an API key on the keys page to authenticate calls. 

curl -X POST https://api.fulcrumgo.com/api/v1/get-job-status \
  -H "Authorization: Bearer mcpsk_<your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "job_id": "5fa4d2c7c5cd4e8aa9b9bc1d6f2c8e1f"
}'

Add this server to Claude Desktop's claude_desktop_config.json. The endpoint becomes a callable tool inside Claude. See the MCP setup guide for the full walk-through. 

{
  "mcpServers": {
    "this-api": {
      "url": "https://api.fulcrumgo.com/mcp",
      "transport": "http",
      "auth": {
        "type": "bearer",
        "token": "mcpsk_<your_api_key>"
      }
    }
  }
}

Inside Claude this endpoint surfaces as the tool get-job-status.

Standard requests — no custom SDK needed. pip install requests first. 

import requests

r = requests.post(
    "https://api.fulcrumgo.com/api/v1/get-job-status",
    headers={"Authorization": "Bearer mcpsk_<your_api_key>"},
    json={
  "job_id": "5fa4d2c7c5cd4e8aa9b9bc1d6f2c8e1f"
},
)
r.raise_for_status()
print(r.json())

Plain fetch. Works in Node 18+, Deno, Bun, and any modern browser. 

const r = await fetch("https://api.fulcrumgo.com/api/v1/get-job-status", {
  method: "POST",
  headers: {
    "Authorization": "Bearer mcpsk_<your_api_key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "job_id": "5fa4d2c7c5cd4e8aa9b9bc1d6f2c8e1f"
}),
});
if (!r.ok) throw new Error(`HTTP ${r.status}`);
console.log(await r.json());

Input

Field Type Required Default Description
job_id string required — The job_id returned by an async tool.
maxLength=64 minLength=8

Output

Field Type Required Default Description
job_id string required —
status string required —
endpoint_slug string required —
queued_at string | null required —
started_at string | null required —
completed_at string | null required —
result any required —
error_message string | null required —
progress_percent integer required —
progress_message string required —
eta_seconds integer | null required —
status_url string required —

Try it

Fires a real POST /api/v1/get-job-status from your browser. Charges 0 credits per call against your account.

Sign in to use Try it. You'll need an API key from the keys page to authenticate the call.