{"versions":{"1.0.1":{"name":"fal-ai-mcp-server","version":"1.0.1","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients","main":"dist/index.js","type":"module","bin":{"fal-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build","test":"echo \"No tests yet\" && exit 0"},"keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/derekalia/fal-mcp-ts.git"},"dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"fal-ai-mcp-server@1.0.1","gitHead":"7479a62b8a3fd1d7a1470bf4c6bcf6b9f16646ec","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-iltmuP6N9agFgEpiOMbLRlmbMtmcCB/YWw2vxDPLkoc3n0gMNBX/g+X1zhjxcqU0scDGQF5i6lL7s4cvbIUXbw==","shasum":"0b5fed61ecd6038c935e016621dd4b14b700e509","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/fal-ai-mcp-server/-/fal-ai-mcp-server-1.0.1.tgz","fileCount":28,"unpackedSize":53896,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHdh4W5WC7kP6UoiUZ32fd3pUA544zhnDwFFcFMeyZxrAiEAsbBV+kNrp877qWjeoTYDU+Q0DQ2Bv9cLvHB8EoDY/fg="}],"size":13186},"_npmUser":{"name":"anonymous","email":"d@posty.run"},"directories":{},"maintainers":[{"name":"anonymous","email":"d@posty.run"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fal-ai-mcp-server_1.0.1_1761260115574_0.7133779689508302"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2025-10-23T22:55:15.782Z","publish_time":1761260115782,"_source_registry_name":"default","contributors":[]},"1.0.2":{"name":"fal-ai-mcp-server","version":"1.0.2","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients","main":"dist/index.js","type":"module","bin":{"fal-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build","test":"echo \"No tests yet\" && exit 0"},"keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/derekalia/fal-mcp-ts.git"},"dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"fal-ai-mcp-server@1.0.2","gitHead":"42686656249a8ef896e4ee9b80c029d600c3012a","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-WYt0Jk/Fp1dQzDksc7d6lyJB1Ny1WHhQacL9cLCmltdnwog19ZKRZPFABHe3kdO7atH9diROTDc2ds/A4hO5tQ==","shasum":"ec962f15ce0df1d38aee2735a38c9fe1cec3f1ac","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/fal-ai-mcp-server/-/fal-ai-mcp-server-1.0.2.tgz","fileCount":28,"unpackedSize":55373,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIC3tIJtW6hM3S5fOr/W9i4kGCApRg9hegc6djyqTRJnrAiBaVkXR76G9PibNfx6pCPwI+XJyNroxQte5NXvMMLpx9g=="}],"size":13693},"_npmUser":{"name":"anonymous","email":"d@posty.run"},"directories":{},"maintainers":[{"name":"anonymous","email":"d@posty.run"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fal-ai-mcp-server_1.0.2_1761260550966_0.7322115258194459"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2025-10-23T23:02:31.187Z","publish_time":1761260551187,"_source_registry_name":"default","contributors":[]},"1.0.3":{"name":"fal-ai-mcp-server","version":"1.0.3","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients","main":"dist/index.js","type":"module","bin":{"fal-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build","test":"echo \"No tests yet\" && exit 0"},"keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/derekalia/fal-mcp-ts.git"},"dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"fal-ai-mcp-server@1.0.3","gitHead":"42686656249a8ef896e4ee9b80c029d600c3012a","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-YZLFir0RiBzAVCTyCVROSgRyuzkJL91+ivE9yUP+UnjuI4EAymT1DFnKZiHG7+HtFB+FmyxgN2liLIYjqQCYeg==","shasum":"0699e1c968db23ac6d3b9d63d47a20fd70e572a6","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/fal-ai-mcp-server/-/fal-ai-mcp-server-1.0.3.tgz","fileCount":28,"unpackedSize":56404,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCZes19R4zBbFxLwTgBaL2G/knW6MHutSR/rJRk+5/LWQIgLtQI8PLX4ZP/26JD01YDr4ephsObxjWeF734aW4Goj4="}],"size":13798},"_npmUser":{"name":"anonymous","email":"d@posty.run"},"directories":{},"maintainers":[{"name":"anonymous","email":"d@posty.run"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fal-ai-mcp-server_1.0.3_1761261013992_0.5080768948168946"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2025-10-23T23:10:14.179Z","publish_time":1761261014179,"_source_registry_name":"default","contributors":[]},"1.0.4":{"name":"fal-ai-mcp-server","version":"1.0.4","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients","main":"dist/index.js","type":"module","bin":{"fal-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build","test":"echo \"No tests yet\" && exit 0"},"keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/derekalia/fal-mcp-ts.git"},"dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"fal-ai-mcp-server@1.0.4","gitHead":"d06e99febffebe447669a6538c311fe574871770","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-xJmbhic/1NXY+MmrVVTpIZF6IrpCNG6hNbGMcxpgmwY4arVFer3YBBluNapc7hEo5BaXQfBZGnPjefre14bCxw==","shasum":"21c44eb879bb29ff46fbc4bffd2a3e93a13b6f8f","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/fal-ai-mcp-server/-/fal-ai-mcp-server-1.0.4.tgz","fileCount":28,"unpackedSize":55338,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDvxeBYvB1uQDVRCjDQoCck6ru2vwa7BiFqP5yCTtF7lwIhAMDa2sduMPYjLlAWSBGbujJ6bt8IURLPkQ5NiIsziv+s"}],"size":13824},"_npmUser":{"name":"anonymous","email":"d@posty.run"},"directories":{},"maintainers":[{"name":"anonymous","email":"d@posty.run"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fal-ai-mcp-server_1.0.4_1761261247603_0.3392248255208308"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2025-10-23T23:14:07.802Z","publish_time":1761261247802,"_source_registry_name":"default","contributors":[]},"1.0.5":{"name":"fal-ai-mcp-server","version":"1.0.5","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients","main":"dist/index.js","type":"module","bin":{"fal-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build","test":"echo \"No tests yet\" && exit 0"},"keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/derekalia/fal-mcp-ts.git"},"dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"fal-ai-mcp-server@1.0.5","gitHead":"f8fd24985cffdfc005cbe09506ec159068a0c2fe","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-8sWtU3nXn/iurCdm17sux7syTMPjrdwH7v/XMguEQwTpbveBMvaQbR8nr2wh3pnZ4V+D2Xt5JzUAAYMnhKcu9Q==","shasum":"ceb0aa06b4e21ce60b994fef5a3b9e567620e01e","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/fal-ai-mcp-server/-/fal-ai-mcp-server-1.0.5.tgz","fileCount":28,"unpackedSize":56441,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDXIkbuOpgXcaFA5jVv/kgjuWJq2zM3NZQrIKUXfaI3PQIgSe7tGOeBibyJn8kkUGcAOlroT7HwrHuZ+OewmEkPTsg="}],"size":14218},"_npmUser":{"name":"anonymous","email":"d@posty.run"},"directories":{},"maintainers":[{"name":"anonymous","email":"d@posty.run"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fal-ai-mcp-server_1.0.5_1761261480716_0.6352937214158196"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2025-10-23T23:18:00.888Z","publish_time":1761261480888,"_source_registry_name":"default","contributors":[]},"1.0.6":{"name":"fal-ai-mcp-server","version":"1.0.6","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients","main":"dist/index.js","type":"module","bin":{"fal-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build","test":"echo \"No tests yet\" && exit 0"},"keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/derekalia/fal-mcp-ts.git"},"dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"fal-ai-mcp-server@1.0.6","gitHead":"9da8e2f68d208f2be311b847a87da82d346a5762","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-Ck1VTlo/N6HqewzWhp6qOjOOQ/telcJAmzM0VbXG66WfUGuA7EccaS/bq+XqxVDfryMTsCjWWSJb4iHmWAjh4Q==","shasum":"f9d14050760334cc476879e548192e94cd51940f","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/fal-ai-mcp-server/-/fal-ai-mcp-server-1.0.6.tgz","fileCount":28,"unpackedSize":57334,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAYBoA9BmBheD2/omyMWTw85CDEOU5A0FaqXjPgzVAf4AiEAoOzRVZt2qDwzJI8RN7tCwRVMIS1RGN7Xu/sbMvOCO70="}],"size":14567},"_npmUser":{"name":"anonymous","email":"d@posty.run"},"directories":{},"maintainers":[{"name":"anonymous","email":"d@posty.run"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fal-ai-mcp-server_1.0.6_1761261654710_0.3206014669509214"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2025-10-23T23:20:54.926Z","publish_time":1761261654926,"_source_registry_name":"default","contributors":[]},"1.1.0":{"name":"fal-ai-mcp-server","version":"1.1.0","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients","main":"dist/index.js","type":"module","bin":{"fal-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build","test":"echo \"No tests yet\" && exit 0"},"keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/derekalia/fal-mcp-ts.git"},"dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"fal-ai-mcp-server@1.1.0","gitHead":"9e5769f662c8263277c9d42e030cacfcafbdbf38","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-phl08GBRHZf1fBGY7oewL/Ymb9Z9gUfjRGo4UuhVjjxiMDgp/l3aKvASmOeFdefopIdKL3cbMBIWJjhGXFh+RA==","shasum":"6fb2f2268cf1c2bb336a08e7c058fb2db8442c3d","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/fal-ai-mcp-server/-/fal-ai-mcp-server-1.1.0.tgz","fileCount":29,"unpackedSize":1096195,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDCjChKV7OR3ahP/6Q1fHXXdRW1Ly5ybpdjxUD8W843GwIhAJb2KelAHenh0fP7cmhqiWU7WOaq0S6wYKLe54rJpeUK"}],"size":1051440},"_npmUser":{"name":"anonymous","email":"d@posty.run"},"directories":{},"maintainers":[{"name":"anonymous","email":"d@posty.run"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fal-ai-mcp-server_1.1.0_1761264859245_0.11910232924902808"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2025-10-24T00:14:19.475Z","publish_time":1761264859475,"_source_registry_name":"default","contributors":[]},"2.0.0":{"name":"fal-ai-mcp-server","version":"2.0.0","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients. Now with Platform API v1 support!","main":"dist/index.js","type":"module","bin":{"fal-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build","test":"echo \"No tests yet\" && exit 0"},"keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/derekalia/fal-mcp-ts.git"},"dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"fal-ai-mcp-server@2.0.0","gitHead":"c142e2017d3407a3662828ef4746e0458044a26e","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-j8DVE4zZ9bg9SppE8PxCDDwvubi4I4eV/TaMOaK2ykmiNxGg6WIGIj14XUzzHKqGXh7jAQzsP9SZAoCbuFg1dA==","shasum":"40d204a9434cb3bc67a29f580078cf79d8419926","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/fal-ai-mcp-server/-/fal-ai-mcp-server-2.0.0.tgz","fileCount":29,"unpackedSize":86471,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCRnT4c75kX35TgWJUKPt/EnbtSjI6gCBdM4+0obhbo2AIhAIaXZW5jsPi2rHSVf9f6loSG64XzUx0m9ain+kNPmsjq"}],"size":19736},"_npmUser":{"name":"anonymous","email":"d@posty.run"},"directories":{},"maintainers":[{"name":"anonymous","email":"d@posty.run"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fal-ai-mcp-server_2.0.0_1761867569237_0.13137207203295165"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2025-10-30T23:39:29.417Z","publish_time":1761867569417,"_source_registry_name":"default","contributors":[]},"2.0.1":{"name":"fal-ai-mcp-server","version":"2.0.1","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients. Now with Platform API v1 support!","main":"dist/index.js","type":"module","bin":{"fal-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build","test":"echo \"No tests yet\" && exit 0"},"keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/derekalia/fal-mcp-ts.git"},"dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"fal-ai-mcp-server@2.0.1","gitHead":"c142e2017d3407a3662828ef4746e0458044a26e","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-6hSBMrrvufUQNxZC/Nh6Hjfm192jSwiQavJ6C/7qwv3TivJqwbrkNfO+e+4ENjiWRNBiQmz0aNtWUO8neAW5hQ==","shasum":"149934416f4865a55b86154e12148e4bcdc0c717","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/fal-ai-mcp-server/-/fal-ai-mcp-server-2.0.1.tgz","fileCount":29,"unpackedSize":87101,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDbWVOOdU7H4ztWfcTz/srzwY2w/uJOkCO19H7sFE9ejAIhAOJTp5QGqVkvvj1A8PHArhRKulshoPU+xf44VBxLRbMl"}],"size":19930},"_npmUser":{"name":"anonymous","email":"d@posty.run"},"directories":{},"maintainers":[{"name":"anonymous","email":"d@posty.run"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fal-ai-mcp-server_2.0.1_1761868282718_0.18650000385864307"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2025-10-30T23:51:22.930Z","publish_time":1761868282930,"_source_registry_name":"default","contributors":[]},"2.1.0":{"name":"fal-ai-mcp-server","version":"2.1.0","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients. Now with Platform API v1 support!","main":"dist/index.js","type":"module","bin":{"fal-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build","test":"echo \"No tests yet\" && exit 0"},"keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/derekalia/fal-mcp-ts.git"},"dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"fal-ai-mcp-server@2.1.0","gitHead":"c142e2017d3407a3662828ef4746e0458044a26e","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-uB1dD3VB6s9GkvciYg9YoOfXoy3YyFIIdk43kYAQ8X221bLaCo88AojnZCW6VUagzXF1FCHTzfTD9TH41yeyHA==","shasum":"63fbf90914cd01fab76e7ef055cca64b3bf9f5cc","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/fal-ai-mcp-server/-/fal-ai-mcp-server-2.1.0.tgz","fileCount":28,"unpackedSize":193143,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBsUychztDUYbv2FjrxEC+oYLcNORfRbA/j3IYQgCVwUAiEA5AA6JFfHPtPolb6+/S+roPiM5zjKbbcOsp9wKGLuoHo="}],"size":30738},"_npmUser":{"name":"anonymous","email":"d@posty.run"},"directories":{},"maintainers":[{"name":"anonymous","email":"d@posty.run"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fal-ai-mcp-server_2.1.0_1761870176123_0.9675985199341206"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2025-10-31T00:22:56.320Z","publish_time":1761870176320,"_source_registry_name":"default","contributors":[]},"2.1.1":{"name":"fal-ai-mcp-server","version":"2.1.1","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients. Now with Platform API v1 support!","main":"dist/index.js","type":"module","bin":{"fal-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build","test":"echo \"No tests yet\" && exit 0"},"keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/derekalia/fal-mcp-ts.git"},"dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"fal-ai-mcp-server@2.1.1","gitHead":"c142e2017d3407a3662828ef4746e0458044a26e","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-TKpJNjRDFNXtcFPZYmnbXns3Ir05GsB0zR5njm1ALWiCFEos0qs5r4j9pmQetKqlAvmWqJ3rGsuk6tbtnxRzSw==","shasum":"ca1ccbbc7a029b7a62f83783d35c31e3b3396c6f","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/fal-ai-mcp-server/-/fal-ai-mcp-server-2.1.1.tgz","fileCount":28,"unpackedSize":193024,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCV8UiJaIZR2XH56X3kyDUD3o+AcHLLkq9Pq/5to549iwIgFnVGNsxyowYGdmGPlH6scXAsn1f2I1FFikC56erPWrQ="}],"size":30751},"_npmUser":{"name":"anonymous","email":"d@posty.run"},"directories":{},"maintainers":[{"name":"anonymous","email":"d@posty.run"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fal-ai-mcp-server_2.1.1_1761870327966_0.13464282276211725"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2025-10-31T00:25:28.151Z","publish_time":1761870328151,"_source_registry_name":"default","contributors":[]},"2.1.2":{"name":"fal-ai-mcp-server","version":"2.1.2","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients. Now with Platform API v1 support!","main":"dist/index.js","type":"module","bin":{"fal-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build","test":"echo \"No tests yet\" && exit 0"},"keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/derekalia/fal-mcp-ts.git"},"dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"fal-ai-mcp-server@2.1.2","gitHead":"f70f53e1356625f48366d3f233ee1df0783e69e7","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-SBuTIarb44uA/bVbpWoKlMIvEWHZGBlm4GNKMOoDlVbfQ2vHFL5dXJnrh/WMlgtRBfsXzaYwFXLmkr4aXDsycA==","shasum":"f17ffc3eead2fbd61c334ff5ebc911972c972629","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/fal-ai-mcp-server/-/fal-ai-mcp-server-2.1.2.tgz","fileCount":26,"unpackedSize":191041,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGDnIAPtLOg5Zq9oB1tv9fblD10NOAXKbbzj3ev5q5TfAiEAoWnZyeKQ+wugLhwLFkpGx/V5jMqz7p1PNAYouo7mS9c="}],"size":30091},"_npmUser":{"name":"anonymous","email":"d@posty.run"},"directories":{},"maintainers":[{"name":"anonymous","email":"d@posty.run"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fal-ai-mcp-server_2.1.2_1761871737969_0.26500667223797225"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2025-10-31T00:48:58.157Z","publish_time":1761871738157,"_source_registry_name":"default","contributors":[]},"2.1.3":{"name":"fal-ai-mcp-server","version":"2.1.3","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients. Now with Platform API v1 support!","main":"dist/index.js","type":"module","bin":{"fal-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build","test":"echo \"No tests yet\" && exit 0"},"keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/derekalia/fal-mcp-ts.git"},"dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"fal-ai-mcp-server@2.1.3","gitHead":"4769f120ba397c7d045b67b7dc21b5ebeec02981","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-V7I4ydLcsiGra9px4YJ9v0PGnS9iZf1XjfV7Gl4hyZmBZgAsJbieYw2TnyppqgU6rXlZqw7uaEU4FDU2kCg9Ag==","shasum":"2a0674ed99eb321f995aed6145d0ac1d3af8adf8","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/fal-ai-mcp-server/-/fal-ai-mcp-server-2.1.3.tgz","fileCount":26,"unpackedSize":194789,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDVLJiBJ15OEHAVe+9HQatx1k67KQleseiTjg+GjsW/UgIhAJrssJ0cgMcz1kJrm09PV3QxRjXVDxs5mPI/VUftrmDz"}],"size":30729},"_npmUser":{"name":"anonymous","email":"d@posty.run"},"directories":{},"maintainers":[{"name":"anonymous","email":"d@posty.run"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fal-ai-mcp-server_2.1.3_1761872041524_0.38855817045787155"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2025-10-31T00:54:01.714Z","publish_time":1761872041714,"_source_registry_name":"default","contributors":[]},"2.1.4":{"name":"fal-ai-mcp-server","version":"2.1.4","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients. Now with Platform API v1 support!","main":"dist/index.js","type":"module","bin":{"fal-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build","test":"echo \"No tests yet\" && exit 0"},"keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/derekalia/fal-mcp-ts.git"},"dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"engines":{"node":">=18.0.0"},"_id":"fal-ai-mcp-server@2.1.4","gitHead":"3b2cdc2c6c1a1cadf0577949fee0060e74372ba0","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-Zaw39ltZD6T//h4vneWvc3+uvAi1ttjF6BcFxqxuCa3WfichOoZF4+L9GhwiwCHsXJJixhcwhqYIq4WPdSHEMQ==","shasum":"02b544822fb848b7b51274a970ef2b2c08f7f96b","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/fal-ai-mcp-server/-/fal-ai-mcp-server-2.1.4.tgz","fileCount":26,"unpackedSize":194475,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDwEw1Z5QjKOESHnww1oMjyv8Bj6L7Exema7MPxVsga6gIgc1/U3fyULj3GzRBtK7AkIbXpI6zOQiEOKttjypIkbPA="}],"size":30705},"_npmUser":{"name":"anonymous","email":"d@posty.run"},"directories":{},"maintainers":[{"name":"anonymous","email":"d@posty.run"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fal-ai-mcp-server_2.1.4_1761872159868_0.4356387898508882"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2025-10-31T00:56:00.084Z","publish_time":1761872160084,"_source_registry_name":"default","contributors":[]}},"dist-tags":{"latest":"2.1.4"},"name":"fal-ai-mcp-server","time":{"created":"2025-10-23T22:55:25.290Z","modified":"2025-10-31T00:56:10.030Z","1.0.1":"2025-10-23T22:55:15.782Z","1.0.2":"2025-10-23T23:02:31.187Z","1.0.3":"2025-10-23T23:10:14.179Z","1.0.4":"2025-10-23T23:14:07.802Z","1.0.5":"2025-10-23T23:18:00.888Z","1.0.6":"2025-10-23T23:20:54.926Z","1.1.0":"2025-10-24T00:14:19.475Z","2.0.0":"2025-10-30T23:39:29.417Z","2.0.1":"2025-10-30T23:51:22.930Z","2.1.0":"2025-10-31T00:22:56.320Z","2.1.1":"2025-10-31T00:25:28.151Z","2.1.2":"2025-10-31T00:48:58.157Z","2.1.3":"2025-10-31T00:54:01.714Z","2.1.4":"2025-10-31T00:56:00.084Z"},"readme":"# fal.ai MCP Server\n\nA Model Context Protocol (MCP) server for interacting with [fal.ai](https://fal.ai) models and services. This server enables Claude Desktop and other MCP clients to discover, search, and generate content using fal.ai's powerful AI models.\n\n## Features\n\n- **Model Discovery**: List and search through fal.ai's model gallery using Platform API v1\n- **Advanced Search**: Free-text search with filtering by category, status, and more\n- **Model Lookup**: Find specific models by endpoint ID with optional schema expansion\n- **Pricing Information**: Get real-time pricing for models (output-based or GPU-based)\n- **Cost Estimation**: Estimate costs using historical API pricing or unit pricing\n- **Usage Tracking**: Get detailed billing usage records with time-series data\n- **Analytics**: Track request counts, latency statistics, and success/error rates\n- **Schema Inspection**: Get detailed input/output schemas with inline OpenAPI expansion\n- **Content Generation**: Generate images, videos, and other content using AI models\n- **Queue Management**: Track generation status, retrieve results, and cancel requests\n- **File Upload**: Upload files to fal.ai CDN for use with models\n- **Full TypeScript Support**: Type-safe API with comprehensive TypeScript definitions\n- **Cursor-based Pagination**: Efficient pagination through large result sets\n\n## Installation\n\n### Via npm (Recommended)\n\n```bash\nnpm install -g fal-ai-mcp-server\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/derekalia/fal-mcp-ts\ncd fal-mcp-ts\nnpm install\nnpm run build\nnpm link\n```\n\n## Configuration\n\n### Get Your API Key\n\n1. Sign up at [fal.ai](https://fal.ai)\n2. Navigate to your [API keys page](https://fal.ai/dashboard/keys)\n3. Create a new API key\n\n### Configure MCP Client\n\nAdd the server to your MCP client configuration. The API key should be provided via environment variables.\n\n#### Claude Desktop\n\nAdd to your Claude Desktop config file:\n\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\\\Claude\\\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"fal\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"fal-ai-mcp-server\"],\n      \"env\": {\n        \"FAL_KEY\": \"your-fal-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n#### Claude Code\n\nFor project-specific configuration, create a `.mcp.json` file in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"fal\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"fal-ai-mcp-server@latest\"],\n      \"env\": {\n        \"FAL_KEY\": \"your-fal-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n**Using `@latest` ensures you always get the newest version automatically!**\n\n**Security Note:** Never commit `.mcp.json` files containing API keys to version control. Add it to your `.gitignore` file.\n\n#### Cursor\n\nAdd to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"fal\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"fal-ai-mcp-server\"],\n      \"env\": {\n        \"FAL_KEY\": \"your-fal-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n#### Other MCP Clients\n\nFor other MCP clients, use the command:\n\n```bash\nFAL_KEY=\"your-api-key\" npx -y fal-ai-mcp-server\n```\n\n## Available Tools\n\n### `models`\n\nList available models in the fal.ai model gallery using the Platform API v1.\n\n**Parameters:**\n- `category` (optional): Filter by category (e.g., \"text-to-image\", \"image-to-video\", \"training\")\n- `cursor` (optional): Pagination cursor from previous response\n- `limit` (optional): Models per page (default: 100, max: 100)\n- `status` (optional): Filter by status - \"active\" or \"deprecated\"\n- `expand` (optional): Array of fields to expand. Supported: [\"openapi-3.0\"] to include full OpenAPI schema\n\n**Example:**\n```javascript\n{\n  \"category\": \"text-to-image\",\n  \"status\": \"active\",\n  \"limit\": 50,\n  \"expand\": [\"openapi-3.0\"]\n}\n```\n\n### `search`\n\nSearch for models using free-text query across name, description, and category.\n\n**Parameters:**\n- `query` (required): Free-text search query\n- `cursor` (optional): Pagination cursor from previous response\n- `limit` (optional): Results per page (default: 50, max: 100)\n- `category` (optional): Filter by category\n- `status` (optional): Filter by status - \"active\" or \"deprecated\"\n- `expand` (optional): Array of fields to expand. Supported: [\"openapi-3.0\"]\n\n**Example:**\n```javascript\n{\n  \"query\": \"flux image generation\",\n  \"status\": \"active\",\n  \"limit\": 20\n}\n```\n\n### `find`\n\nFind specific model(s) by endpoint ID. Can retrieve single or multiple models.\n\n**Parameters:**\n- `endpoint_ids` (required): Array of endpoint IDs (1-50 models)\n- `expand` (optional): Array of fields to expand. Supported: [\"openapi-3.0\"]\n\n**Example:**\n```javascript\n{\n  \"endpoint_ids\": [\"fal-ai/flux/dev\", \"fal-ai/flux-pro\"],\n  \"expand\": [\"openapi-3.0\"]\n}\n```\n\n### `schema`\n\nGet the input/output schema for a specific model.\n\n**Parameters:**\n- `app_id` (required): Model application ID (e.g., \"fal-ai/flux/dev\")\n\n**Example:**\n```javascript\n{\n  \"app_id\": \"fal-ai/flux/dev\"\n}\n```\n\n### `generate`\n\nSubmit a generation request to a fal.ai model.\n\n**Parameters:**\n- `app_id` (required): Model application ID\n- `input_data` (required): Model-specific input parameters\n- `webhook_url` (optional): Webhook for result notification\n- `output_format` (optional): \"json\" or \"binary\" (default: \"json\")\n\n**Example:**\n```javascript\n{\n  \"app_id\": \"fal-ai/flux/dev\",\n  \"input_data\": {\n    \"prompt\": \"A beautiful sunset over mountains\",\n    \"image_size\": \"landscape_4_3\",\n    \"num_inference_steps\": 28\n  }\n}\n```\n\n### `result`\n\nGet the result of a generation request.\n\n**Parameters:**\n- `app_id` (required): Model application ID\n- `request_id` (required): Request ID from `generate()`\n\n**Example:**\n```javascript\n{\n  \"app_id\": \"fal-ai/flux/dev\",\n  \"request_id\": \"abc123-def456-ghi789\"\n}\n```\n\n### `status`\n\nCheck the status of a generation request without fetching full results.\n\n**Parameters:**\n- `app_id` (required): Model application ID\n- `request_id` (required): Request ID to check\n\n**Example:**\n```javascript\n{\n  \"app_id\": \"fal-ai/flux/dev\",\n  \"request_id\": \"abc123-def456-ghi789\"\n}\n```\n\n### `cancel`\n\nCancel a pending or processing generation request.\n\n**Parameters:**\n- `app_id` (required): Model application ID\n- `request_id` (required): Request ID to cancel\n\n**Example:**\n```javascript\n{\n  \"app_id\": \"fal-ai/flux/dev\",\n  \"request_id\": \"abc123-def456-ghi789\"\n}\n```\n\n### `upload`\n\nUpload a file to fal.ai CDN for use with models.\n\n**Parameters:**\n- `file_path` (required): Path to the file to upload\n- `content_type` (optional): MIME type (auto-detected if not provided)\n\n**Example:**\n```javascript\n{\n  \"file_path\": \"/path/to/image.png\"\n}\n```\n\n### `pricing`\n\nGet pricing information for specific model endpoint(s). Requires authentication.\n\n**Parameters:**\n- `endpoint_ids` (required): Array of endpoint IDs to get pricing for (1-50 models)\n- `cursor` (optional): Pagination cursor from previous response\n\n**Example:**\n```javascript\n{\n  \"endpoint_ids\": [\"fal-ai/flux/dev\", \"fal-ai/flux-pro\"]\n}\n```\n\n**Response:**\n```javascript\n{\n  \"prices\": [\n    {\n      \"endpoint_id\": \"fal-ai/flux/dev\",\n      \"unit_price\": 0.025,\n      \"unit\": \"image\",\n      \"currency\": \"USD\"\n    }\n  ],\n  \"next_cursor\": null,\n  \"has_more\": false\n}\n```\n\n### `estimate_cost`\n\nEstimate costs for model operations. Requires authentication. Useful for budget planning and cost optimization.\n\n**Estimation Methods:**\n\n1. **Historical API Price** (`historical_api_price`):\n   - Based on historical pricing per API call from past usage patterns\n   - Use when you know the number of API calls you'll make\n   - Example: \"How much will 100 calls to flux/dev cost?\"\n\n2. **Unit Price** (`unit_price`):\n   - Based on unit price × expected billing units (images, videos, etc.)\n   - Use when you know the expected output quantity\n   - Example: \"How much will 50 images from flux/dev cost?\"\n\n**Parameters:**\n- `estimate_type` (required): Either \"historical_api_price\" or \"unit_price\"\n- `endpoints` (required): Map of endpoint IDs to quantities\n\n**Example - Historical API Price:**\n```javascript\n{\n  \"estimate_type\": \"historical_api_price\",\n  \"endpoints\": {\n    \"fal-ai/flux/dev\": {\n      \"call_quantity\": 100\n    },\n    \"fal-ai/flux/schnell\": {\n      \"call_quantity\": 50\n    }\n  }\n}\n```\n\n**Example - Unit Price:**\n```javascript\n{\n  \"estimate_type\": \"unit_price\",\n  \"endpoints\": {\n    \"fal-ai/flux/dev\": {\n      \"unit_quantity\": 50\n    },\n    \"fal-ai/flux-pro\": {\n      \"unit_quantity\": 25\n    }\n  }\n}\n```\n\n**Response:**\n```javascript\n{\n  \"estimate_type\": \"unit_price\",\n  \"total_cost\": 1.88,\n  \"currency\": \"USD\"\n}\n```\n\n### `usage`\n\nGet usage records for your workspace with detailed billing information. Returns time-series data and/or summary statistics with unit quantities and prices. Requires authentication.\n\n**Parameters:**\n- `endpoint_ids` (required): Array of endpoint IDs to get usage for (1-50 models)\n- `start` (optional): Start date in ISO8601 format (e.g., \"2025-01-01\" or \"2025-01-01T00:00:00Z\"). Defaults to 24 hours ago\n- `end` (optional): End date in ISO8601 format. Defaults to current time\n- `timeframe` (optional): Aggregation timeframe - \"minute\", \"hour\", \"day\", \"week\", or \"month\". Auto-detected if not specified\n- `timezone` (optional): Timezone for date aggregation (e.g., \"UTC\", \"America/New_York\"). Defaults to \"UTC\"\n- `bound_to_timeframe` (optional): Whether to align start/end dates to timeframe boundaries. Defaults to true\n- `expand` (optional): Array of data to include - \"time_series\", \"summary\", \"auth_method\". Defaults to [\"time_series\"]\n- `cursor` (optional): Pagination cursor from previous response\n- `limit` (optional): Maximum number of items to return\n\n**Example:**\n```javascript\n{\n  \"endpoint_ids\": [\"fal-ai/flux/dev\", \"fal-ai/nano-banana\"],\n  \"start\": \"2025-10-01\",\n  \"end\": \"2025-10-31\",\n  \"timeframe\": \"day\",\n  \"expand\": [\"time_series\", \"summary\"]\n}\n```\n\n**Response:**\n```javascript\n{\n  \"time_series\": [\n    {\n      \"bucket\": \"2025-10-23T00:00:00+00:00\",\n      \"results\": [\n        {\n          \"endpoint_id\": \"fal-ai/flux/dev\",\n          \"unit\": \"shared_gateway_request\",\n          \"quantity\": 8,\n          \"unit_price\": 0.025\n        }\n      ]\n    }\n  ],\n  \"summary\": [\n    {\n      \"endpoint_id\": \"fal-ai/flux/dev\",\n      \"unit\": \"shared_gateway_request\",\n      \"quantity\": 15,\n      \"unit_price\": 0.025\n    }\n  ]\n}\n```\n\n### `analytics`\n\nGet analytics data for model endpoints with time-bucketed metrics. Returns request counts, latency statistics (avg, p50, p95, p99), and success/error rates. Requires authentication.\n\n**Parameters:**\n- `endpoint_ids` (required): Array of endpoint IDs to get analytics for (1-50 models)\n- `start` (optional): Start date in ISO8601 format. Defaults to 24 hours ago\n- `end` (optional): End date in ISO8601 format. Defaults to current time\n- `timeframe` (optional): Time bucket size - \"hour\", \"day\", \"week\", or \"month\". Auto-detected if not specified\n- `timezone` (optional): Timezone for date aggregation. Defaults to \"UTC\"\n- `bound_to_timeframe` (optional): Whether to align start/end dates to timeframe boundaries. Defaults to true\n- `metric` (optional): Filter to return only specific metric - \"total_requests\", \"successful_requests\", \"failed_requests\", or \"avg_latency_ms\"\n- `cursor` (optional): Pagination cursor from previous response\n- `limit` (optional): Maximum number of items to return\n\n**Example:**\n```javascript\n{\n  \"endpoint_ids\": [\"fal-ai/flux/dev\"],\n  \"start\": \"2025-10-01\",\n  \"timeframe\": \"day\"\n}\n```\n\n**Response:**\n```javascript\n{\n  \"time_series\": [\n    {\n      \"bucket\": \"2025-10-23T00:00:00+00:00\",\n      \"results\": [\n        {\n          \"endpoint_id\": \"fal-ai/flux/dev\",\n          \"request_count\": 19\n        }\n      ]\n    }\n  ]\n}\n```\n\n## Usage Examples\n\n### With Claude Desktop\n\nOnce configured, you can use natural language to interact with fal.ai:\n\n**Model Discovery:**\n> \"Search for active flux models\"\n\n> \"Find the model details for fal-ai/flux/dev\"\n\n**Pricing & Cost Management:**\n> \"Get pricing information for fal-ai/flux/dev and fal-ai/flux-pro\"\n\n> \"Estimate the cost of generating 50 images using fal-ai/flux/dev\"\n\n> \"How much would 100 API calls to flux/dev cost based on historical pricing?\"\n\n**Usage & Analytics:**\n> \"Show me my usage for fal-ai/nano-banana in the last 2 weeks\"\n\n> \"Get analytics for fal-ai/flux/dev for the past month\"\n\n> \"What's my total spending on flux/dev this month?\"\n\n**Content Generation:**\n> \"Generate an image of a cat wearing a hat using fal-ai/flux/dev\"\n\n> \"Check the status of my last generation request\"\n\n> \"Upload this image to fal.ai CDN: /path/to/image.png\"\n\n### Programmatic Usage\n\nYou can also use the server programmatically:\n\n```typescript\nimport { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\n// ... server setup\n```\n\n## Development\n\n### Prerequisites\n\n- Node.js 18 or later\n- npm or yarn\n- fal.ai API key\n\n### Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/derekalia/fal-mcp-ts\ncd fal-mcp-ts\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run in development mode with watch\nnpm run watch\n```\n\n### Project Structure\n\n```\nfal-mcp-ts/\n├── src/\n│   ├── index.ts           # Main server entry point\n│   ├── client.ts          # Fal.ai client wrapper\n│   └── tools/\n│       ├── models.ts      # Model discovery tools\n│       ├── generate.ts    # Generation and queue tools\n│       └── storage.ts     # File upload tools\n├── dist/                  # Compiled output\n├── package.json\n├── tsconfig.json\n└── README.md\n```\n\n## Troubleshooting\n\n### \"FAL_KEY environment variable is not set\"\n\nMake sure you've set the `FAL_KEY` in your MCP client configuration. The API key must be set as an environment variable.\n\n### \"HTTP 401\" or \"Unauthorized\"\n\nYour API key may be invalid or expired. Check your API key at [fal.ai/dashboard/keys](https://fal.ai/dashboard/keys).\n\n### Build Errors\n\nTry removing `node_modules` and reinstalling:\n\n```bash\nrm -rf node_modules package-lock.json\nnpm install\nnpm run build\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nMIT\n\n## Credits\n\nThis project was inspired by the [Python fal MCP server](https://github.com/am0y/mcp-fal) and built using:\n- [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/sdk) - MCP TypeScript SDK\n- [@fal-ai/client](https://github.com/fal-ai/fal-js) - Official fal.ai TypeScript client\n\n## Links\n\n- [fal.ai](https://fal.ai) - AI model platform\n- [Model Context Protocol](https://modelcontextprotocol.io) - MCP documentation\n- [Claude Desktop](https://claude.ai/desktop) - Claude Desktop app","users":{}}