fal.ai MCP by usefulapi

Working · 818 ms

io.usefulapi/falaiv1.21.0 Domain verified

Run fal.ai models, poll the inference queue and read model schemas.

Design & Creative

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://falai.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

falai_cancel_request Destructive

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.

model_idstring, required

The fal.ai model id, used raw as a path segment, e.g. 'fal-ai/flux/schnell'.

request_idstring, required

The queue request id returned when the request was submitted.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Tools (7)

falai_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

Argument	Type	Description
model_id*	string	The fal.ai model id, used raw as a path segment, e.g. 'fal-ai/flux/schnell'.
request_id*	string	The queue request id returned when the request was submitted.

Input schema (JSON)

{
  "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 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

Argument	Type	Description
model_id*	string	The fal.ai model id, used raw as a path segment, e.g. 'fal-ai/flux/schnell'.

Input schema (JSON)

{
  "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 the final output of a COMPLETED queued request. fal.ai queue: GET {queue}/{model_id}/requests/{request_id}.

read-only

Argument	Type	Description
model_id*	string	The fal.ai model id, used raw as a path segment, e.g. 'fal-ai/flux/schnell'.
request_id*	string	The queue request id returned when the request was submitted.

Input schema (JSON)

{
  "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 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

Argument	Type	Description
logs	boolean	Include queue logs in the response (?logs=1).
model_id*	string	The fal.ai model id, used raw as a path segment, e.g. 'fal-ai/flux/schnell'.
request_id*	string	The queue request id returned when the request was submitted.

Input schema (JSON)

{
  "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 or search fal.ai models in the registry (paginated). fal.ai API: GET /models (query: keywords, page, total).

read-only

Argument	Type	Description
page	integer	1-based page number (default 1).
total	integer	Page size (number of models per page).
keywords	string	Optional search string to filter models by.

Input schema (JSON)

{
  "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

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

Argument	Type	Description
input*	object	The model's input object — arbitrary params for that model, e.g. { "prompt": "a cat" }. Use falai_get_model_schema to learn the fields.
model_id*	string	The fal.ai model id, used raw as a path segment, e.g. 'fal-ai/flux/schnell'.
max_wait_seconds	integer	Max seconds to wait for completion (default 60, capped at 300).
poll_interval_seconds	integer	Seconds between status polls (default 3, min 1).

Input schema (JSON)

{
  "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 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

Argument	Type	Description
input*	object	The model's input object — arbitrary params for that model, e.g. { "prompt": "a cat" }. Use falai_get_model_schema to learn the fields.
model_id*	string	The fal.ai model id, used raw as a path segment, e.g. 'fal-ai/flux/schnell'.

Input schema (JSON)

{
  "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'."
    }
  }
}