AI GIF Maker MCP server

README.md

# 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](https://aigifmaker.ai/?utm_source=mcp&utm_medium=package). 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](https://aigifmaker.ai/pricing?utm_source=mcp&utm_medium=package) page.

## Install

```bash
npx -y aigifmaker-mcp
```

### Claude Desktop / Claude Code / Cursor / Cline

```json
{
  "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

```bash
gemini extensions install https://github.com/hanshs474/aigifmaker-mcp
```

### Claude Code plugin

```bash
claude plugin marketplace add hanshs474/aigifmaker-mcp
claude plugin install aigifmaker@aigifmaker
```

### Docker

```bash
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

```bash
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

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4/5.0

Scored 2026-11-09 20:00 across 3 tools

Disambiguation5/5

Each tool targets a distinct action on a distinct concern: generate_gif creates a job, check_gif polls a specific job by task id, and check_credits reads account balance. There is no plausible way to confuse one with another, and the descriptions make the generation-then-poll flow explicit.

Naming Consistency5/5

All three tools follow the same verb_noun snake_case pattern (generate_gif, check_gif, check_credits), with the shared 'check_' prefix clearly grouping the two read-only/free operations.

Tool Count4/5

Three tools is at the lean end but each earns its place: generation, async polling, and credit lookup are all necessary for the stated workflow. Nothing extraneous, though the surface is thin enough that any addition (cancel, history) would round it out.

Completeness4/5

The core lifecycle is covered end to end: submit a prompt, retrieve the result asynchronously, and verify the account has credits before spending. Minor gaps exist — no way to cancel or delete a job, list past GIFs, or check status without the task id — but agents can work around these.

Maintenance

ActivityMaintained

ResponsivenessNo recent community issues

TDQS

Maintenance

Resources