Plug GIFs into anything

Free API keys. A REST API that feels like GIPHY's, an MCP server for AI assistants, oEmbed, embeds and RSS. Sign up for a key

1 · MCP server (Claude, ChatGPT, Cursor, your bots)

Endpoint: https://www.dirtygiffy.com/mcp · Streamable HTTP · auth with your key.

Claude Code

claude mcp add --transport http dirty-giffy https://www.dirtygiffy.com/mcp --header "Authorization: Bearer YOUR_KEY"

Claude Desktop / claude.ai custom connector, ChatGPT connectors and others that only take a URL:

https://www.dirtygiffy.com/mcp?key=YOUR_KEY

Cursor / VS Code mcp.json:

{
  "mcpServers": {
    "dirty-giffy": {
      "url": "https://www.dirtygiffy.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

Tools: search_gifs, trending_gifs, newest_gifs, random_gif, get_gif, get_embed_code, suggest_tags. All read-only. Every tool takes an optional rating ceiling.

2 · REST API

Base: https://www.dirtygiffy.com/api/v1 · send Authorization: Bearer YOUR_KEY (or ?api_key=). 120 calls/minute per key.

EndpointWhat it does
GET /gifs/search?q=&limit=&offset=&rating=&category=Search by phrase or tag
GET /gifs/trending?limit=&category=&rating=What's hot now
GET /gifs/new?limit=&offset=Newest approved
GET /gifs/random?tag=&rating=One random GIF
GET /gifs/{id}One GIF, every rendition
GET /tags/autocomplete?q=Search suggestions
GET /categoriesMoods and spice levels
curl -H "Authorization: Bearer YOUR_KEY" "https://www.dirtygiffy.com/api/v1/gifs/search?q=u%20up&limit=3&rating=cheeky"

Each GIF comes back with images.original (GIF), images.mp4, images.preview (small animated WebP) and images.still (JPG), plus url and embed_url. Please link back to the GIF page when you show one.

3 · Embeds, oEmbed and feeds