giphy-mcp-server
Provides tools for searching, trending, and random GIFs, as well as translating phrases to GIFs via the Giphy API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@giphy-mcp-server search for a funny cat GIF"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
giphy-mcp-server
MCP server for the Giphy API — search, trending, and random GIFs as tools for AI coding agents.
Tools
Tool | Description |
| Search for GIFs by query string |
| Get currently trending GIFs |
| Get a random GIF, optionally filtered by tag |
| Get a specific GIF by its Giphy ID |
| Translate a word or phrase to the perfect GIF |
Related MCP server: Giphy MCP Server
Setup
Get a free API key at developers.giphy.com
Set the
GIPHY_API_KEYenvironment 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-serverFrom source
git clone https://github.com/npow/giphy-mcp-server.git
cd giphy-mcp-server
pip install -e .
giphy-mcp-serverDevelopment
pip install -e ".[test]"
pytestLicense
MIT
Available Tools
5 toolsget_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
get_trending_gifsA
Get currently trending GIFs on Giphy.
Args: 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").
Inputs: limit, offset, 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
Scored across 5 tools
Each tool has a distinct purpose: get by ID, random, trending, search, and translate. There is no overlap, and descriptions clearly differentiate them.
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).
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.
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
Related MCP Connectors
Search GIFs and retrieve animated media URLs; show reactions in clients that support MCP Apps.
Giphy MCP — wraps Giphy API (public beta key, free)
Compress GIFs from HTTPS URLs, poll results, and check credits. Hosted MCP with API key auth.
Look up Pokémon, moves, abilities, items, natures, and type matchups from PokéAPI v2.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI models to search, retrieve, and utilize GIFs from Giphy with features like content filtering, multiple search methods, and comprehensive metadata.3238 npm36MIT
- FlicenseNot gradedqualityDmaintenanceThis 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.-
- FlicenseNot gradedqualityDmaintenanceAn 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.-
- -licenseNot gradedqualityNot gradedmaintenanceAn 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.-