Skip to main content
Glama
giphy-mcp-server
by npow

giphy-mcp-server

MCP server for the Giphy API — search, trending, and random GIFs as tools for AI coding agents.

Tools

Tool

Description

search_gifs

Search for GIFs by query string

get_trending_gifs

Get currently trending GIFs

get_random_gif

Get a random GIF, optionally filtered by tag

get_gif_by_id

Get a specific GIF by its Giphy ID

translate

Translate a word or phrase to the perfect GIF

Related MCP server: Giphy MCP Server

Setup

  1. Get a free API key at developers.giphy.com

  2. Set the GIPHY_API_KEY environment variable

Usage

With Claude Code

{
  "mcpServers": {
    "giphy": {
      "command": "uvx",
      "args": ["giphy-mcp-server"],
      "env": {
        "GIPHY_API_KEY": "your-api-key-here"
      }
    }
  }
}

With pip

pip install giphy-mcp-server
giphy-mcp-server

From source

git clone https://github.com/npow/giphy-mcp-server.git
cd giphy-mcp-server
pip install -e .
giphy-mcp-server

Development

pip install -e ".[test]"
pytest

License

MIT

Available Tools

5 tools
get_gif_by_idA

Get a specific GIF by its Giphy ID.

Args: gif_id: The Giphy GIF ID (e.g. "xT9IgzoKnwFNmISR8I").

Inputs: gif_id (required). Returns: result

get_random_gifA

Get a random GIF from Giphy, optionally filtered by tag.

Args: tag: Tag to limit random results (e.g. "cats", "happy"). Optional. rating: Content rating filter: "g", "pg", "pg-13", or "r" (default "g").

Inputs: tag, rating. Returns: result

search_gifsA

Search for GIFs on Giphy.

Args: query: Search query term or phrase (e.g. "funny cats", "thumbs up"). limit: Max number of results to return (default 10, max 50). offset: Results offset for pagination (default 0). rating: Content rating filter: "g", "pg", "pg-13", or "r" (default "g"). lang: Language code (default "en").

Inputs: query (required), limit, offset, rating, +1 more. Returns: result

translateA

Translate a word or phrase to the perfect GIF using Giphy's WeirdnesS algorithm.

This is Giphy's special "translate" endpoint that converts a term into the single most relevant GIF. Great for reactions and responses.

Args: term: Term or phrase to translate (e.g. "excited", "oh no"). rating: Content rating filter: "g", "pg", "pg-13", or "r" (default "g").

Inputs: term (required), rating. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a distinct purpose: get by ID, random, trending, search, and translate. There is no overlap, and descriptions clearly differentiate them.

    Naming Consistency4/5

    Names use consistent snake_case and mostly follow a verb_noun pattern (e.g., get_gif_by_id, search_gifs). However, 'translate' is a bare verb and there is minor singular/plural inconsistency (gif vs gifs).

    Tool Count5/5

    With 5 tools, the server is well-scoped for a GIF retrieval API. Each tool serves a common use case without being overly numerous or sparse.

    Completeness4/5

    The toolset covers the main Giphy features for reading GIFs (by ID, random, trending, search, translate). Missing endpoints like stickers or batch retrieval are minor gaps, but core functionality is complete.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI models to search, retrieve, and utilize GIFs from Giphy with features like content filtering, multiple search methods, and comprehensive metadata.
      3
      238 npm
      36
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      This is an auto-generated Multi-Agent Conversation Protocol server that enables interaction with the Giphy API, allowing users to access and use Giphy's GIF services through natural language commands.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP (Multi-Agent Conversation Protocol) Server that enables interaction with the Giphy API, allowing agents to search, retrieve, and manage GIF animations through natural language commands.
      -
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      An MCP (Multi-Agent Conversation Protocol) Server that enables interaction with the Giphy API, allowing users to search, retrieve, and manipulate GIF content through natural language commands.
      -