mcpField
A
aigifmaker-mcp

aigifmaker-mcp

Local
aigifmaker.aiMedia & Design0Updated 4d ago
RepositoryVisit website

About aigifmaker-mcp

aigifmaker-mcp is the official MCP server for AI GIF Maker, turning text prompts into animated GIFs for users of MCP clients. It returns a GIF URL and also provides tools to check queued jobs and account credits.

Key features

  1. 01Generate an animated GIF from text
  2. 02Check queued GIF generation tasks
  3. 03View remaining account credits

Use cases

  1. 01Create an animated GIF from a chat prompt
  2. 02Retrieve a GIF after generation remains queued
  3. 03Check credits before requesting a GIF

MCP support

Exposes `generate_gif`, `check_gif`, and `check_credits` tools to MCP clients. GIF generation uses the account associated with the configured API key and returns a GIF URL.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "hanshs474-aigifmaker": {
      "command": "npx",
      "args": [
        "-y",
        "aigifmaker-mcp"
      ],
      "env": {
        "AIGIFMAKER_API_KEY": "<AIGIFMAKER_API_KEY>"
      }
    }
  }
}
Run commandnpx -y aigifmaker-mcp
Environment variables to set
AIGIFMAKER_API_KEYSecretAPI key from https://aigifmaker.ai/settings/apikeys

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmaigifmaker-mcp0.1.0

Tools

2

Saved tool list · updated 4d ago

ParameterTypeRequiredDescription
promptstringYesWhat the GIF should show and how it moves, e.g. "a corgi in sunglasses dancing on a beach, looping".

Details

From the project README

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: [email protected]

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.