{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_nvsnnj9bqjbb","handle":"fal-ai-mcp-2","url":"https://wellknown.network/agents/fal-ai-mcp-2","links":{"self":"https://wellknown.network/agents/fal-ai-mcp-2/record.json","html":"https://wellknown.network/agents/fal-ai-mcp-2","markdown":"https://wellknown.network/agents/fal-ai-mcp-2/record.md","api":"https://wellknown.network/api/v1/agents/fal-ai-mcp-2","status":"https://wellknown.network/api/v1/agents/fal-ai-mcp-2/status","claim":"https://wellknown.network/agents/fal-ai-mcp-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/fal-ai-mcp-2/claim.json","badge":"https://wellknown.network/agents/fal-ai-mcp-2/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/fal-ai-mcp-2/history","tools":"https://wellknown.network/api/v1/agents/fal-ai-mcp-2/tools"},"ard":{"identifier":"urn:air::server:fal-ai-mcp-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"fal-ai-mcp","summary":"A Model Context Protocol (MCP) server for generating images using Fal.ai's HiDream-I1-Full model","description":"# FAL AI Image Generator MCP\n\nA Model Context Protocol (MCP) server for generating images using the FAL.ai platform and HiDream-ai/HiDream-I1-Full model.\n\n## Quick Start\n\n1. **Get a FAL.ai API Key**\n\n - Sign up at [FAL.ai](https://www.fal.ai) and obtain your API key\n\n2. **Install the package**\n```bash\n# Using pip\npip install fal-ai-mcp\n\n# Using uv\nuv pip install fal-ai-mcp\n```\n\n3. **Run and Test the server**\n```bash\n# Using Python module\nexport FAL_KEY=\"your-fal-api-key\" && npx @modelcontextprotocol/inspector -- python -m fal_ai_mcp\n\n# Using uvx (alternative method)\nexport FAL_KEY=\"your-fal-api-key\" && npx @modelcontextprotocol/inspector uvx fal-ai-mcp\n```\n\n## Configure in Claude Desktop, Cursor or Windsurf\n\nAdd this configuration to your MCP config file:\n\n#### Method 1: Using uvx\n\n```json\n{\n  \"mcpServers\": {\n    \"fal-ai-image-generator\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"fal-ai-mcp\"\n      ],\n      \"env\": {\n        \"FAL_KEY\": \"your-fal-api-key\"\n      }\n    }\n  }\n}\n```\n\n#### Method 2: Using Python module\n\n```json\n{\n  \"mcpServers\": {\n    \"fal-ai-image-generator\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"fal_ai_mcp\"],\n      \"env\": {\n        \"FAL_KEY\": \"your-fal-api-key\"\n      }\n    }\n  }\n}\n```\n\n## Features\n\nThis MCP server provides a tool for generating high-quality images from text prompts using FAL.ai platform:\n\n- Text-to-image generation using the `text_to_image_fal` tool\n- Returns complete metadata including image URL or base64 image data, dimensions, and other information\n- Easy integration with MCP-compatible applications\n\n## API Reference\n\n### `text_to_image_fal`\n\nGenerates an image from a text prompt using the FAL.ai API and HiDream-I1-Full model.\n\n**Parameters:**\n- `prompt` (string): The text description of the image you want to generate\n\n**Returns:**\n- A dictionary containing the generated image data, including:\n  - `images`: Array of generated images with URLs, dimensions, and content type\n  - `timings`: Performance metrics\n  - `s…","publisher":null,"homepage":"https://github.com/yourusername/fal-ai-mcp","repository":"https://github.com/yourusername/fal-ai-mcp/issues","version":"0.1.3","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:fal-ai-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"media.image-generation","name":"Image Generation","confidence":0.917,"provenance":"derived"}],"categories":["media"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"fal-ai-mcp","registry":"pypi","observedAt":"2026-11-03T02:25:18.695Z","publishedAt":"2025-04-21T09:35:17.435314Z","latestVersion":"0.1.3"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"fal-ai-mcp","url":"https://pypi.org/project/fal-ai-mcp/","firstSeenAt":"2026-09-09T15:22:19.751Z","fetchedAt":"2026-11-03T02:24:30.021Z","normalizedAt":"2026-11-03T02:24:30.021Z"}]},"firstSeenAt":"2026-09-09T15:22:19.751Z","updatedAt":"2026-11-03T02:25:18.695Z"}