MCP Server

falai

io.usefulapi/falai
AI & Agents Developer Tools Public & reachable MCP 2026-07-28

What this MCP does

Lists fal.ai models, retrieves model schemas, submits and monitors inference requests, obtains results and cancels queued requests.

falai_cancel_request
Cancel request
Request cancellation of a queued (not-yet-started) request. Returns 202 { status: 'CANCELLATION_REQUESTED' }. fal.ai queue: PUT {queue}/{model_id}/requests/{request_id}/cancel.
Destructive
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['model_id', 'request_id'], 'properties': {'model_id': {'type': 'string', 'minLength': 1, 'description': "The fal.ai model id, used raw as a path segment, e.g. 'fal-ai/flux/schnell'."}, 'request_id': {'type': 'string', 'minLength': 1, 'description': 'The queue request id returned when the request was submitted.'}}}
falai_get_model_schema
Get model schema
Get the OpenAPI 3 schema for a model — its input/output fields (components.schemas). Use this to learn what inputs a model accepts before submitting. fal.ai API: GET /openapi/queue/openapi.json?endpoint_id={model_id}.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['model_id'], 'properties': {'model_id': {'type': 'string', 'minLength': 1, 'description': "The fal.ai model id, used raw as a path segment, e.g. 'fal-ai/flux/schnell'."}}}
falai_get_request_result
Get request result
Get the final output of a COMPLETED queued request. fal.ai queue: GET {queue}/{model_id}/requests/{request_id}.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['model_id', 'request_id'], 'properties': {'model_id': {'type': 'string', 'minLength': 1, 'description': "The fal.ai model id, used raw as a path segment, e.g. 'fal-ai/flux/schnell'."}, 'request_id': {'type': 'string', 'minLength': 1, 'description': 'The queue request id returned when the request was submitted.'}}}
falai_get_request_status
Get request status
Get the status of a queued request (IN_QUEUE | IN_PROGRESS | COMPLETED). fal.ai queue: GET {queue}/{model_id}/requests/{request_id}/status (optional logs=1).
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['model_id', 'request_id'], 'properties': {'logs': {'type': 'boolean', 'description': 'Include queue logs in the response (?logs=1).'}, 'model_id': {'type': 'string', 'minLength': 1, 'description': "The fal.ai model id, used raw as a path segment, e.g. 'fal-ai/flux/schnell'."}, 'request_id': {'type': 'string', 'minLength': 1, 'description': 'The queue request id returned when the request was submitted.'}}}
falai_list_models
List models
List or search fal.ai models in the registry (paginated). fal.ai API: GET /models (query: keywords, page, total).
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': '1-based page number (default 1).'}, 'total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page size (number of models per page).'}, 'keywords': {'type': 'string', 'description': 'Optional search string to filter models by.'}}}
falai_run_model
Run model (subscribe)
Convenience 'subscribe': submit a request, poll its status until COMPLETED, then return the result. Consumes fal credits. If it does not complete within the wait budget, returns a { status, request_id, status_url, note } object (NOT an error) so you can keep polling with falai_get_request_status / falai_get_request_result.
Destructive
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['model_id', 'input'], 'properties': {'input': {'type': 'object', 'description': 'The model\'s input object — arbitrary params for that model, e.g. { "prompt": "a cat" }. Use falai_get_model_schema to learn the fields.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'model_id': {'type': 'string', 'minLength': 1, 'description': "The fal.ai model id, used raw as a path segment, e.g. 'fal-ai/flux/schnell'."}, 'max_wait_seconds': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Max seconds to wait for completion (default 60, capped at 300).'}, 'poll_interval_seconds': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Seconds between status polls (default 3, min 1).'}}}
falai_submit_request
Submit request
Submit an inference request to the queue and return immediately (async — does NOT wait for completion). Returns { request_id, response_url, status_url, cancel_url, queue_position }. Consumes fal credits when the model runs. fal.ai queue: POST {queue}/{model_id} with body = the model input.
Destructive
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['model_id', 'input'], 'properties': {'input': {'type': 'object', 'description': 'The model\'s input object — arbitrary params for that model, e.g. { "prompt": "a cat" }. Use falai_get_model_schema to learn the fields.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'model_id': {'type': 'string', 'minLength': 1, 'description': "The fal.ai model id, used raw as a path segment, e.g. 'fal-ai/flux/schnell'."}}}
Changed
falai_cancel_request
Oct. 2, 2026, 2:40 a.m.
Changed
falai_run_model
Oct. 2, 2026, 2:40 a.m.
Changed
falai_submit_request
Oct. 2, 2026, 2:40 a.m.
Changed
falai_get_request_result
Oct. 2, 2026, 2:40 a.m.
Changed
falai_get_request_status
Oct. 2, 2026, 2:40 a.m.
Changed
falai_get_model_schema
Oct. 2, 2026, 2:40 a.m.
Changed
falai_list_models
Oct. 2, 2026, 2:40 a.m.
Added
falai_cancel_request
Sept. 30, 2026, 2:40 a.m.
Added
falai_run_model
Sept. 30, 2026, 2:40 a.m.
Added
falai_submit_request
Sept. 30, 2026, 2:40 a.m.
Added
falai_get_request_result
Sept. 30, 2026, 2:40 a.m.
Added
falai_get_request_status
Sept. 30, 2026, 2:40 a.m.
Added
falai_get_model_schema
Sept. 30, 2026, 2:40 a.m.
Added
falai_list_models
Sept. 30, 2026, 2:40 a.m.