
aigifmaker-mcp
io.github.hanshs474/aigifmaker-mcp
MCP server for AI GIF Maker (aigifmaker.ai): turn text into animated GIFs from any MCP client.
Documentation
AI GIF Maker MCP server
Turn text into animated GIFs with AI GIF Maker. Native GIF generation — no video conversion. Type what you want and download your GIF in about a minute.
This is the official MCP server for AI GIF Maker. It lets Claude, Cursor, Cline, Gemini CLI or any MCP client make a GIF on your own account: describe it in chat, get the GIF URL back.
Tools
| Tool | What it does |
|---|---|
generate_gif | Text prompt in, animated GIF URL out. Waits for the GIF (usually about a minute) |
check_gif | Collects a GIF that was still queued when generate_gif returned (free to call) |
check_credits | Credits left on your account (free to call) |
API key
Create one at https://aigifmaker.ai/settings/apikeys and set it as AIGIFMAKER_API_KEY.
Each GIF costs 1 credit on your AI GIF Maker account, the same as on the website. New accounts get one free GIF (it carries a small aigifmaker.ai badge). A GIF that fails to generate gives its credit back. Credit packs are on the pricing page.
Install
npx -y aigifmaker-mcp
Claude Desktop / Claude Code / Cursor / Cline
{
"mcpServers": {
"aigifmaker": {
"command": "npx",
"args": ["-y", "aigifmaker-mcp"],
"env": { "AIGIFMAKER_API_KEY": "sk-..." }
}
}
}
Claude Code in one line: claude mcp add aigifmaker -e AIGIFMAKER_API_KEY=sk-... -- npx -y aigifmaker-mcp
Gemini CLI
gemini extensions install https://github.com/hanshs474/aigifmaker-mcp
Claude Code plugin
claude plugin marketplace add hanshs474/aigifmaker-mcp
claude plugin install aigifmaker@aigifmaker
Docker
docker build -t aigifmaker-mcp . && docker run -i --rm -e AIGIFMAKER_API_KEY=sk-... aigifmaker-mcp
Notes
- A run from an account that has not bought credits yet may wait in a short queue before it starts;
generate_gifkeeps waiting (up to 5 minutes); if it is still queued after that, it returns the task id andcheck_gifcollects the GIF when it is ready. - Text to GIF only. There is no frame count, size, photo-to-GIF or editing option.
AIGIFMAKER_BASE_URLoverrides the endpoint; only useful against a local build of the site.
Development
npm install
npm test # build + mocked unit tests, offline
node --test test/smoke.live.mjs # two free live checks, no generation
MIT licensed. Questions: support@aigifmaker.ai
aigifmaker-mcpnpm install aigifmaker-mcp