usefulapi

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

Claude

Open Settings → Connectors → Add custom connector
Paste this URL:
https://falai.usefulapi.io/mcp
Authenticate with fal.ai when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

{
  "mcpServers": {
    "falai": {
      "url": "https://falai.usefulapi.io/mcp"
    }
  }
}

live7 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 7

Tool	Type	What it does
`falai_list_models`	read	List models List or search fal.ai models in the registry (paginated). fal.ai API: GET /models (query: keywords, page, total).
`falai_get_model_schema`	read	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}.
`falai_get_request_status`	read	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).
`falai_get_request_result`	read	Get request result Get the final output of a COMPLETED queued request. fal.ai queue: GET {queue}/{model_id}/requests/{request_id}.
`falai_submit_request`	write	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.
`falai_run_model`	write	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.
`falai_cancel_request`	write	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.

Pricing

Plan	Price	Limit
Free	$0	100 tool calls / month
Pro	$9/mo · $90/yr	Unlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.