An MCP (Model Contex Protocol) Server to use the fal.ai APIs to generate images and videos.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"fal-ai-mcp-server-2","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Fal AI MCP Server An MCP (Model Context Protocol) server to use the fal.ai APIs to generate images and videos. This is a barebones server that anyone can extend to use different fal.ai models and API endpoints. ## Usage Install [uv](https://docs.astral.sh/uv/) and add the server to an MCP config using `uvx`: ```json { "name": "fal-ai-mcp-server", "command": "uvx", "args": [ "fal-ai-mcp-server" ], "env": { "FAL_KEY": "your-key", "SAVE_MEDIA_DIR": "path/to/save/images" } } ``` or clone the repo and use `uv` with a directory: ```json { "name": "fal-ai-mcp-server", "command": "uv", "args": [ "--directory", "path/to/root/dir/", "run", "main.py" ], "env": { "FAL_KEY": "your-key", "SAVE_MEDIA_DIR": "path/to/save/images" } } ``` ## Development ### Testing Clone the repo and use [mcp-client-for-testing](https://github.com/piebro/mcp-client-for-testing) to test the tools of the server. ```bash uvx mcp-client-for-testing \ --config ' [ { "name": "fal-ai-mcp-server", "command": "uv", "args": [ "--directory", "path/to/root/dir/", "run", "main.py" ], "env": { "FAL_KEY": "your-key", "SAVE_MEDIA_DIR": "path/to/save/images" } } ] ' \ --tool_call '{"name": "echo_tool", "arguments": {"message": "Hello, world!"}}' ``` ### Formatting and Linting The code is formatted and linted with ruff: ```bash uv run ruff format uv run ruff check --fix ``` ### Building with uv Build the package using uv: ```bash uv build ``` ### Releasing a New Version To release a new version of the package to PyPI, create and push a new Git tag: 1. Checkout the main branch and get the current version: ```bash git checkout main git pull origin main git describe …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.