Repository avatar
AI Tools
v0.1.0
active

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

ToolWhat it does
generate_gifText prompt in, animated GIF URL out. Waits for the GIF (usually about a minute)
check_gifCollects a GIF that was still queued when generate_gif returned (free to call)
check_creditsCredits 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_gif keeps waiting (up to 5 minutes); if it is still queued after that, it returns the task id and check_gif collects the GIF when it is ready.
  • Text to GIF only. There is no frame count, size, photo-to-GIF or editing option.
  • AIGIFMAKER_BASE_URL overrides 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