fal MCP "why did my request fail": the Sume job equivalent
fal's Platform MCP lets an assistant debug a failed request. For a failed Sume media job, read jobs_events and the error, then retry by the error rules.

fal's Platform MCP server is for asking an assistant "why did my last request to my-app fail?" about your fal account. Sume has the same kind of loop for media jobs: from hosted MCP, an agent reads jobs_status, jobs_events, and jobs_result for the job id, then retries according to the error.
The fal facts are from its changelog (Aug 17 entry, read 2026-10-01). This compares the workflow, not the features one for one. Sume details are from Jobs and results.
What does the fal Platform MCP do?
The changelog describes a second MCP server at https://api.fal.ai/v1/mcp/platform that lets an assistant operate your fal account. It lists 15 tools: eleven serverless debugging tools covering requests, logs, error analytics, deploy and revision history, runner and queue state, spend, and storage, plus a four-tool discovery gateway. It is read-only, stateless, and free. Setup is in fal MCP server setup and billing.
How do I ask the same question about a Sume job?
Give the agent the job id. The hosted MCP job read tools are jobs_list, jobs_get, jobs_status, jobs_result, jobs_events, and jobs_wait. Over HTTP the same timeline is GET /v1/jobs/{id}/events, a pull snapshot rather than a stream.
| Event | What it tells the agent |
|---|---|
job.created / job.queued | The job was accepted and is waiting |
job.started / generation.submitted | Work began |
job.failed | Terminal failure with a public error |
job.canceled | Someone canceled it |
webhook.delivery | A callback attempt, if you set a webhook |
What should the agent do once it knows why?
Follow the error envelope rules. Back off on 429 and use retry-after when present; queue_full is not ordinary rate limiting and clears when an existing job finishes or is canceled. Do not retry unsafe submits without an Idempotency-Key. The public events do not expose raw provider task ids or URLs, so the answer comes from the Sume error, not provider internals.
Does a failure mean I was billed?
The docs say a client timeout does not cancel a job and it still bills. For a terminal failure, read the job's error and your usage records before assuming either way; see errors and credits.
Sources
Related posts
More in Integrations
- How to add an MCP server to ChatGPT with developer mode
Turn on ChatGPT developer mode, create an app for the server's URL, and sign in with OAuth. The steps, with Sume's hosted MCP server as the example.
- How to add subtitles to a video in Python
Add subtitles to a video in Python with Requests: POST the video URL to Sume's /v1/video-captions, poll the job, then read the captioned video_url.
- Add Sume to Claude as a custom connector (remote MCP)
Add Sume's hosted MCP server to Claude under Customize > Connectors, see what Sume's OAuth consent grants, and decide whether to allow paid tools.
- Airflow HTTP sensor: wait for an AI video job to finish
Submit an AI video job with Airflow's HttpOperator, then wait with an HttpSensor in reschedule mode that passes once the job's status is completed.
Written by Sume