@swiftimg/mcp-server

A Model Context Protocol server that gives Claude Desktop, Cursor, Continue.dev, and any other MCP-aware AI client direct tools to upload images to swiftimg, search GIFs, and inspect image metadata — all from inside a conversation.

Why this exists

LLMs are getting good at agentic workflows (build me a landing page, draft a release blog, summarize this dashboard) but they have nowhere to put the images those workflows generate. This MCP server fills that gap: ask the model to upload a screenshot, embed a GIF, or check the EXIF of a URL, and it just works — the tools are right there.

Install

The server is published to npm and is meant to be launched on demand via npx. Add it to your MCP client config:

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "swiftimg": {
      "command": "npx",
      "args": ["-y", "@swiftimg/mcp-server"],
      "env": {
        "SWIFTIMG_API_KEY": "your-key-here"
      }
    }
  }
}

Cursor (.cursor/mcp.json or workspace config)

{
  "mcpServers": {
    "swiftimg": {
      "command": "npx",
      "args": ["-y", "@swiftimg/mcp-server"],
      "env": { "SWIFTIMG_API_KEY": "your-key-here" }
    }
  }
}

Continue.dev (config.json)

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "@swiftimg/mcp-server"]
        }
      }
    ]
  }
}

The SWIFTIMG_API_KEY environment variable is optional — without it, uploads count against the anonymous free-tier daily cap. With it, uploads attribute to your account and use your plan's per-file caps. Set SWIFTIMG_API_BASE to override the API origin (useful for Business-plan white-label tenants).

Tools

| Tool | Description | | ------------------- | ----------------------------------------------------------------------------------------------------------------- | | upload_image | Upload a local file or remote URL; returns the direct image URL, viewer page URL, and id. | | search_gifs | Full-text search across swiftimg's public animated GIFs. | | trending_gifs | List the most-viewed GIFs (default surface before a search query). | | get_image_info | Width, height, format, MIME, and file size from any remote image URL. | | inspect_og | OpenGraph + Twitter Card unfurl preview for any page URL (Slack/X/Discord-style). | | get_animated_info | Frame count, total duration, dimensions, and loop behaviour for a GIF or animated WebP URL. |

Example prompts

"Upload ~/Desktop/screenshot.png to swiftimg with the title 'Settings redesign' and the tag 'ui' — then paste the URL into the draft tweet."

"Find me three trending GIFs that say 'thumbs up' and embed the smallest one in my reply."

"What does this page unfurl like in Slack?"

"What's the dimension and format of the image at this URL?"

Local development

npm install
npm run build
npm run start     # starts the server on stdio

Point your MCP client at the built binary:

{
  "command": "node",
  "args": ["/absolute/path/to/swiftimg-mcp-server/dist/index.js"]
}

Underlying API

Every tool is a thin wrapper around the public swiftimg REST API:

• POST /v1/images — image upload
• GET /v1/gifs/search?q=… — GIF search
• GET /v1/gifs/trending — trending GIFs
• GET /tools/image-info.json?url=… — image metadata
• GET /tools/og-preview.json?url=… — OG / Twitter Card metadata
• GET /tools/animated-info.json?url=… — animation timing

See openapi.json for the canonical machine-readable spec.

License

MIT.