{"_id":"fal-ai-mcp-server","_rev":"14-a413e9278698d7addad2f215d6daecd0","name":"fal-ai-mcp-server","dist-tags":{"latest":"2.1.4"},"versions":{"1.0.1":{"name":"fal-ai-mcp-server","version":"1.0.1","keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","_id":"fal-ai-mcp-server@1.0.1","maintainers":[{"name":"d_posty","email":"d@posty.run"}],"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"bin":{"fal-mcp-server":"dist/index.js"},"dist":{"shasum":"0b5fed61ecd6038c935e016621dd4b14b700e509","tarball":"https://registry.npmjs.org/fal-ai-mcp-server/-/fal-ai-mcp-server-1.0.1.tgz","fileCount":28,"integrity":"sha512-iltmuP6N9agFgEpiOMbLRlmbMtmcCB/YWw2vxDPLkoc3n0gMNBX/g+X1zhjxcqU0scDGQF5i6lL7s4cvbIUXbw==","signatures":[{"sig":"MEUCIHdh4W5WC7kP6UoiUZ32fd3pUA544zhnDwFFcFMeyZxrAiEAsbBV+kNrp877qWjeoTYDU+Q0DQ2Bv9cLvHB8EoDY/fg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":53896},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"7479a62b8a3fd1d7a1470bf4c6bcf6b9f16646ec","scripts":{"test":"echo \"No tests yet\" && exit 0","build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"d_posty","email":"d@posty.run"},"repository":{"url":"git+https://github.com/derekalia/fal-mcp-ts.git","type":"git"},"_npmVersion":"10.9.2","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients","directories":{},"_nodeVersion":"22.14.0","dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/fal-ai-mcp-server_1.0.1_1761260115574_0.7133779689508302","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"fal-ai-mcp-server","version":"1.0.2","keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","_id":"fal-ai-mcp-server@1.0.2","maintainers":[{"name":"d_posty","email":"d@posty.run"}],"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"bin":{"fal-mcp-server":"dist/index.js"},"dist":{"shasum":"ec962f15ce0df1d38aee2735a38c9fe1cec3f1ac","tarball":"https://registry.npmjs.org/fal-ai-mcp-server/-/fal-ai-mcp-server-1.0.2.tgz","fileCount":28,"integrity":"sha512-WYt0Jk/Fp1dQzDksc7d6lyJB1Ny1WHhQacL9cLCmltdnwog19ZKRZPFABHe3kdO7atH9diROTDc2ds/A4hO5tQ==","signatures":[{"sig":"MEQCIC3tIJtW6hM3S5fOr/W9i4kGCApRg9hegc6djyqTRJnrAiBaVkXR76G9PibNfx6pCPwI+XJyNroxQte5NXvMMLpx9g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":55373},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"42686656249a8ef896e4ee9b80c029d600c3012a","scripts":{"test":"echo \"No tests yet\" && exit 0","build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"d_posty","email":"d@posty.run"},"repository":{"url":"git+https://github.com/derekalia/fal-mcp-ts.git","type":"git"},"_npmVersion":"10.9.2","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients","directories":{},"_nodeVersion":"22.14.0","dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/fal-ai-mcp-server_1.0.2_1761260550966_0.7322115258194459","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"fal-ai-mcp-server","version":"1.0.3","keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","_id":"fal-ai-mcp-server@1.0.3","maintainers":[{"name":"d_posty","email":"d@posty.run"}],"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"bin":{"fal-mcp-server":"dist/index.js"},"dist":{"shasum":"0699e1c968db23ac6d3b9d63d47a20fd70e572a6","tarball":"https://registry.npmjs.org/fal-ai-mcp-server/-/fal-ai-mcp-server-1.0.3.tgz","fileCount":28,"integrity":"sha512-YZLFir0RiBzAVCTyCVROSgRyuzkJL91+ivE9yUP+UnjuI4EAymT1DFnKZiHG7+HtFB+FmyxgN2liLIYjqQCYeg==","signatures":[{"sig":"MEUCIQCZes19R4zBbFxLwTgBaL2G/knW6MHutSR/rJRk+5/LWQIgLtQI8PLX4ZP/26JD01YDr4ephsObxjWeF734aW4Goj4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":56404},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"42686656249a8ef896e4ee9b80c029d600c3012a","scripts":{"test":"echo \"No tests yet\" && exit 0","build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"d_posty","email":"d@posty.run"},"repository":{"url":"git+https://github.com/derekalia/fal-mcp-ts.git","type":"git"},"_npmVersion":"10.9.2","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients","directories":{},"_nodeVersion":"22.14.0","dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/fal-ai-mcp-server_1.0.3_1761261013992_0.5080768948168946","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"fal-ai-mcp-server","version":"1.0.4","keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","_id":"fal-ai-mcp-server@1.0.4","maintainers":[{"name":"d_posty","email":"d@posty.run"}],"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"bin":{"fal-mcp-server":"dist/index.js"},"dist":{"shasum":"21c44eb879bb29ff46fbc4bffd2a3e93a13b6f8f","tarball":"https://registry.npmjs.org/fal-ai-mcp-server/-/fal-ai-mcp-server-1.0.4.tgz","fileCount":28,"integrity":"sha512-xJmbhic/1NXY+MmrVVTpIZF6IrpCNG6hNbGMcxpgmwY4arVFer3YBBluNapc7hEo5BaXQfBZGnPjefre14bCxw==","signatures":[{"sig":"MEYCIQDvxeBYvB1uQDVRCjDQoCck6ru2vwa7BiFqP5yCTtF7lwIhAMDa2sduMPYjLlAWSBGbujJ6bt8IURLPkQ5NiIsziv+s","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":55338},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"d06e99febffebe447669a6538c311fe574871770","scripts":{"test":"echo \"No tests yet\" && exit 0","build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"d_posty","email":"d@posty.run"},"repository":{"url":"git+https://github.com/derekalia/fal-mcp-ts.git","type":"git"},"_npmVersion":"10.9.2","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients","directories":{},"_nodeVersion":"22.14.0","dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/fal-ai-mcp-server_1.0.4_1761261247603_0.3392248255208308","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"fal-ai-mcp-server","version":"1.0.5","keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","_id":"fal-ai-mcp-server@1.0.5","maintainers":[{"name":"d_posty","email":"d@posty.run"}],"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"bin":{"fal-mcp-server":"dist/index.js"},"dist":{"shasum":"ceb0aa06b4e21ce60b994fef5a3b9e567620e01e","tarball":"https://registry.npmjs.org/fal-ai-mcp-server/-/fal-ai-mcp-server-1.0.5.tgz","fileCount":28,"integrity":"sha512-8sWtU3nXn/iurCdm17sux7syTMPjrdwH7v/XMguEQwTpbveBMvaQbR8nr2wh3pnZ4V+D2Xt5JzUAAYMnhKcu9Q==","signatures":[{"sig":"MEUCIQDXIkbuOpgXcaFA5jVv/kgjuWJq2zM3NZQrIKUXfaI3PQIgSe7tGOeBibyJn8kkUGcAOlroT7HwrHuZ+OewmEkPTsg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":56441},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"f8fd24985cffdfc005cbe09506ec159068a0c2fe","scripts":{"test":"echo \"No tests yet\" && exit 0","build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"d_posty","email":"d@posty.run"},"repository":{"url":"git+https://github.com/derekalia/fal-mcp-ts.git","type":"git"},"_npmVersion":"10.9.2","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients","directories":{},"_nodeVersion":"22.14.0","dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/fal-ai-mcp-server_1.0.5_1761261480716_0.6352937214158196","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"fal-ai-mcp-server","version":"1.0.6","keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","_id":"fal-ai-mcp-server@1.0.6","maintainers":[{"name":"d_posty","email":"d@posty.run"}],"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"bin":{"fal-mcp-server":"dist/index.js"},"dist":{"shasum":"f9d14050760334cc476879e548192e94cd51940f","tarball":"https://registry.npmjs.org/fal-ai-mcp-server/-/fal-ai-mcp-server-1.0.6.tgz","fileCount":28,"integrity":"sha512-Ck1VTlo/N6HqewzWhp6qOjOOQ/telcJAmzM0VbXG66WfUGuA7EccaS/bq+XqxVDfryMTsCjWWSJb4iHmWAjh4Q==","signatures":[{"sig":"MEUCIAYBoA9BmBheD2/omyMWTw85CDEOU5A0FaqXjPgzVAf4AiEAoOzRVZt2qDwzJI8RN7tCwRVMIS1RGN7Xu/sbMvOCO70=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57334},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"9da8e2f68d208f2be311b847a87da82d346a5762","scripts":{"test":"echo \"No tests yet\" && exit 0","build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"d_posty","email":"d@posty.run"},"repository":{"url":"git+https://github.com/derekalia/fal-mcp-ts.git","type":"git"},"_npmVersion":"10.9.2","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients","directories":{},"_nodeVersion":"22.14.0","dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/fal-ai-mcp-server_1.0.6_1761261654710_0.3206014669509214","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"fal-ai-mcp-server","version":"1.1.0","keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","_id":"fal-ai-mcp-server@1.1.0","maintainers":[{"name":"d_posty","email":"d@posty.run"}],"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"bin":{"fal-mcp-server":"dist/index.js"},"dist":{"shasum":"6fb2f2268cf1c2bb336a08e7c058fb2db8442c3d","tarball":"https://registry.npmjs.org/fal-ai-mcp-server/-/fal-ai-mcp-server-1.1.0.tgz","fileCount":29,"integrity":"sha512-phl08GBRHZf1fBGY7oewL/Ymb9Z9gUfjRGo4UuhVjjxiMDgp/l3aKvASmOeFdefopIdKL3cbMBIWJjhGXFh+RA==","signatures":[{"sig":"MEYCIQDCjChKV7OR3ahP/6Q1fHXXdRW1Ly5ybpdjxUD8W843GwIhAJb2KelAHenh0fP7cmhqiWU7WOaq0S6wYKLe54rJpeUK","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1096195},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"9e5769f662c8263277c9d42e030cacfcafbdbf38","scripts":{"test":"echo \"No tests yet\" && exit 0","build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"d_posty","email":"d@posty.run"},"repository":{"url":"git+https://github.com/derekalia/fal-mcp-ts.git","type":"git"},"_npmVersion":"10.9.2","description":"Model Context Protocol (MCP) server for fal.ai - interact with AI models through Claude and other MCP clients","directories":{},"_nodeVersion":"22.14.0","dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/fal-ai-mcp-server_1.1.0_1761264859245_0.11910232924902808","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"fal-ai-mcp-server","version":"2.0.0","keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","_id":"fal-ai-mcp-server@2.0.0","maintainers":[{"name":"d_posty","email":"d@posty.run"}],"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"bin":{"fal-mcp-server":"dist/index.js"},"dist":{"shasum":"40d204a9434cb3bc67a29f580078cf79d8419926","tarball":"https://registry.npmjs.org/fal-ai-mcp-server/-/fal-ai-mcp-server-2.0.0.tgz","fileCount":29,"integrity":"sha512-j8DVE4zZ9bg9SppE8PxCDDwvubi4I4eV/TaMOaK2ykmiNxGg6WIGIj14XUzzHKqGXh7jAQzsP9SZAoCbuFg1dA==","signatures":[{"sig":"MEYCIQCRnT4c75kX35TgWJUKPt/EnbtSjI6gCBdM4+0obhbo2AIhAIaXZW5jsPi2rHSVf9f6loSG64XzUx0m9ain+kNPmsjq","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":86471},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"c142e2017d3407a3662828ef4746e0458044a26e","scripts":{"test":"echo \"No tests yet\" && exit 0","build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"d_posty","email":"d@posty.run"},"repository":{"url":"git+https://github.com/derekalia/fal-mcp-ts.git","type":"git"},"_npmVersion":"10.9.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!","directories":{},"_nodeVersion":"22.14.0","dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/fal-ai-mcp-server_2.0.0_1761867569237_0.13137207203295165","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"fal-ai-mcp-server","version":"2.0.1","keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","_id":"fal-ai-mcp-server@2.0.1","maintainers":[{"name":"d_posty","email":"d@posty.run"}],"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"bin":{"fal-mcp-server":"dist/index.js"},"dist":{"shasum":"149934416f4865a55b86154e12148e4bcdc0c717","tarball":"https://registry.npmjs.org/fal-ai-mcp-server/-/fal-ai-mcp-server-2.0.1.tgz","fileCount":29,"integrity":"sha512-6hSBMrrvufUQNxZC/Nh6Hjfm192jSwiQavJ6C/7qwv3TivJqwbrkNfO+e+4ENjiWRNBiQmz0aNtWUO8neAW5hQ==","signatures":[{"sig":"MEYCIQDbWVOOdU7H4ztWfcTz/srzwY2w/uJOkCO19H7sFE9ejAIhAOJTp5QGqVkvvj1A8PHArhRKulshoPU+xf44VBxLRbMl","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":87101},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"c142e2017d3407a3662828ef4746e0458044a26e","scripts":{"test":"echo \"No tests yet\" && exit 0","build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"d_posty","email":"d@posty.run"},"repository":{"url":"git+https://github.com/derekalia/fal-mcp-ts.git","type":"git"},"_npmVersion":"10.9.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!","directories":{},"_nodeVersion":"22.14.0","dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/fal-ai-mcp-server_2.0.1_1761868282718_0.18650000385864307","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"fal-ai-mcp-server","version":"2.1.0","keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","_id":"fal-ai-mcp-server@2.1.0","maintainers":[{"name":"d_posty","email":"d@posty.run"}],"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"bin":{"fal-mcp-server":"dist/index.js"},"dist":{"shasum":"63fbf90914cd01fab76e7ef055cca64b3bf9f5cc","tarball":"https://registry.npmjs.org/fal-ai-mcp-server/-/fal-ai-mcp-server-2.1.0.tgz","fileCount":28,"integrity":"sha512-uB1dD3VB6s9GkvciYg9YoOfXoy3YyFIIdk43kYAQ8X221bLaCo88AojnZCW6VUagzXF1FCHTzfTD9TH41yeyHA==","signatures":[{"sig":"MEUCIBsUychztDUYbv2FjrxEC+oYLcNORfRbA/j3IYQgCVwUAiEA5AA6JFfHPtPolb6+/S+roPiM5zjKbbcOsp9wKGLuoHo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":193143},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"c142e2017d3407a3662828ef4746e0458044a26e","scripts":{"test":"echo \"No tests yet\" && exit 0","build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"d_posty","email":"d@posty.run"},"repository":{"url":"git+https://github.com/derekalia/fal-mcp-ts.git","type":"git"},"_npmVersion":"10.9.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!","directories":{},"_nodeVersion":"22.14.0","dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/fal-ai-mcp-server_2.1.0_1761870176123_0.9675985199341206","host":"s3://npm-registry-packages-npm-production"}},"2.1.1":{"name":"fal-ai-mcp-server","version":"2.1.1","keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","_id":"fal-ai-mcp-server@2.1.1","maintainers":[{"name":"d_posty","email":"d@posty.run"}],"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"bin":{"fal-mcp-server":"dist/index.js"},"dist":{"shasum":"ca1ccbbc7a029b7a62f83783d35c31e3b3396c6f","tarball":"https://registry.npmjs.org/fal-ai-mcp-server/-/fal-ai-mcp-server-2.1.1.tgz","fileCount":28,"integrity":"sha512-TKpJNjRDFNXtcFPZYmnbXns3Ir05GsB0zR5njm1ALWiCFEos0qs5r4j9pmQetKqlAvmWqJ3rGsuk6tbtnxRzSw==","signatures":[{"sig":"MEUCIQCV8UiJaIZR2XH56X3kyDUD3o+AcHLLkq9Pq/5to549iwIgFnVGNsxyowYGdmGPlH6scXAsn1f2I1FFikC56erPWrQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":193024},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"c142e2017d3407a3662828ef4746e0458044a26e","scripts":{"test":"echo \"No tests yet\" && exit 0","build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"d_posty","email":"d@posty.run"},"repository":{"url":"git+https://github.com/derekalia/fal-mcp-ts.git","type":"git"},"_npmVersion":"10.9.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!","directories":{},"_nodeVersion":"22.14.0","dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/fal-ai-mcp-server_2.1.1_1761870327966_0.13464282276211725","host":"s3://npm-registry-packages-npm-production"}},"2.1.2":{"name":"fal-ai-mcp-server","version":"2.1.2","keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","_id":"fal-ai-mcp-server@2.1.2","maintainers":[{"name":"d_posty","email":"d@posty.run"}],"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"bin":{"fal-mcp-server":"dist/index.js"},"dist":{"shasum":"f17ffc3eead2fbd61c334ff5ebc911972c972629","tarball":"https://registry.npmjs.org/fal-ai-mcp-server/-/fal-ai-mcp-server-2.1.2.tgz","fileCount":26,"integrity":"sha512-SBuTIarb44uA/bVbpWoKlMIvEWHZGBlm4GNKMOoDlVbfQ2vHFL5dXJnrh/WMlgtRBfsXzaYwFXLmkr4aXDsycA==","signatures":[{"sig":"MEUCIGDnIAPtLOg5Zq9oB1tv9fblD10NOAXKbbzj3ev5q5TfAiEAoWnZyeKQ+wugLhwLFkpGx/V5jMqz7p1PNAYouo7mS9c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":191041},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"f70f53e1356625f48366d3f233ee1df0783e69e7","scripts":{"test":"echo \"No tests yet\" && exit 0","build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"d_posty","email":"d@posty.run"},"repository":{"url":"git+https://github.com/derekalia/fal-mcp-ts.git","type":"git"},"_npmVersion":"10.9.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!","directories":{},"_nodeVersion":"22.14.0","dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/fal-ai-mcp-server_2.1.2_1761871737969_0.26500667223797225","host":"s3://npm-registry-packages-npm-production"}},"2.1.3":{"name":"fal-ai-mcp-server","version":"2.1.3","keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"author":{"name":"Derek Alia"},"license":"MIT","_id":"fal-ai-mcp-server@2.1.3","maintainers":[{"name":"d_posty","email":"d@posty.run"}],"homepage":"https://github.com/derekalia/fal-mcp-ts#readme","bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"bin":{"fal-mcp-server":"dist/index.js"},"dist":{"shasum":"2a0674ed99eb321f995aed6145d0ac1d3af8adf8","tarball":"https://registry.npmjs.org/fal-ai-mcp-server/-/fal-ai-mcp-server-2.1.3.tgz","fileCount":26,"integrity":"sha512-V7I4ydLcsiGra9px4YJ9v0PGnS9iZf1XjfV7Gl4hyZmBZgAsJbieYw2TnyppqgU6rXlZqw7uaEU4FDU2kCg9Ag==","signatures":[{"sig":"MEYCIQDVLJiBJ15OEHAVe+9HQatx1k67KQleseiTjg+GjsW/UgIhAJrssJ0cgMcz1kJrm09PV3QxRjXVDxs5mPI/VUftrmDz","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":194789},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"4769f120ba397c7d045b67b7dc21b5ebeec02981","scripts":{"test":"echo \"No tests yet\" && exit 0","build":"tsc && chmod +x dist/index.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"d_posty","email":"d@posty.run"},"repository":{"url":"git+https://github.com/derekalia/fal-mcp-ts.git","type":"git"},"_npmVersion":"10.9.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!","directories":{},"_nodeVersion":"22.14.0","dependencies":{"@fal-ai/client":"^1.1.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/fal-ai-mcp-server_2.1.3_1761872041524_0.38855817045787155","host":"s3://npm-registry-packages-npm-production"}},"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":"https://registry.npmjs.org/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="}]},"_npmUser":{"name":"d_posty","email":"d@posty.run"},"directories":{},"maintainers":[{"name":"d_posty","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}},"time":{"created":"2025-10-23T22:55:15.460Z","modified":"2025-10-31T00:56:00.251Z","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"},"bugs":{"url":"https://github.com/derekalia/fal-mcp-ts/issues"},"author":{"name":"Derek Alia"},"license":"MIT","homepage":"https://github.com/derekalia/fal-mcp-ts#readme","keywords":["mcp","model-context-protocol","fal","fal.ai","ai","image-generation","llm","claude"],"repository":{"type":"git","url":"git+https://github.com/derekalia/fal-mcp-ts.git"},"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!","maintainers":[{"name":"d_posty","email":"d@posty.run"}],"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\n","readmeFilename":"README.md"}