Log inSubmit server
MCP Server Giphy logo

MCP Server Giphy

by magarcia

Search, filter, paginate, and retrieve Giphy GIFs through MCP tools using a Giphy API key.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Server Giphy

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "magarcia-mcp-server-giphy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-giphy"
      ],
      "env": {
        "GIPHY_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y mcp-server-giphy

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 23d ago.

Overview

The magarcia/mcp-server-giphy MCP server connects MCP clients to the Giphy API for searching and retrieving GIFs. It provides tools for query-based searches, random GIF selection, and trending GIF retrieval, with controls for rating, language, tags, result limits, and offsets. Responses include GIF identifiers, titles, Giphy page URLs, image-format URLs, dimensions, and available metadata. Reach for it when an agent needs to find GIFs or return structured Giphy media information.

Use cases

  • Search Giphy for GIFs matching an agent-generated phrase
  • Retrieve a random GIF filtered by tag and rating
  • Browse trending GIFs with pagination
  • Select an image format using returned dimensions and URLs

Key features

  • Query-based GIF search
  • Random GIF retrieval
  • Trending GIF retrieval
  • Rating and language filters
  • Pagination with limit and offset
  • GIF metadata and image-format details

Tools6

What MCP Server Giphy lets your agent do. Expand a tool for its parameters.

Self-reported~7 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

19/19 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · mcp-server-giphy (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars36Stargazers on the source repository.
npm downloads648Package downloads in the last 30 days.
Last commit1y agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed6Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Server Giphy works

What magarcia/mcp-server-giphy MCP server does

The magarcia/mcp-server-giphy MCP server exposes selected Giphy API operations through MCP. It lets an MCP-compatible AI client search Giphy with a text query, request a random GIF, or retrieve currently trending GIFs. The server is intended for workflows where an agent needs to discover GIFs and receive their associated URLs and metadata rather than interact with Giphy through a browser.

Search results and individual GIF responses can include the Giphy identifier, title, page URL, image variants, image dimensions, and other metadata when available. The image object may contain multiple formats, each with a direct image URL and width and height values.

How it works

The client calls one of three tools:

  • search_gifs accepts a required query and optional limit, offset, rating, and language values.
  • get_random_gif returns one random GIF and can narrow the result with a tag or content rating.
  • get_trending_gifs returns a paginated list of trending GIFs and accepts limit, offset, and rating values.

Search and trending requests default to 10 results and support up to 50. Their offset values provide pagination control. Search uses English by default when no language is supplied. Rating values can be selected from Giphy's documented options: g, pg, pg-13, or r.

Setup and configuration

The magarcia/mcp-server-giphy MCP server requires a Giphy API key. Create a Giphy Developer account, register an application, and obtain the key from the Giphy developer dashboard.

For Claude Desktop, configure an MCP server entry that runs npx -y mcp-server-giphy and passes GIPHY_API_KEY in the entry's environment. The repository also documents a local development flow using npm install, npm run build, and npm start. Development mode, tests, and MCP Inspector usage are available through the repository's npm scripts.

Tools and capabilities

search_gifs supports text-based discovery with pagination, content-rating filtering, and language selection. get_random_gif is useful when a workflow needs an unpredictable result, optionally constrained by a tag and rating. get_trending_gifs exposes Giphy's current trending collection with pagination and rating filtering.

The response format is organized for agent use and preserves practical media details. A client can use the returned page URL to refer to the GIF on Giphy or use one of the image URLs and its dimensions when choosing a format.

Limitations and notes

Requests depend on a valid Giphy API key and the access level associated with that key. The material does not specify rate limits, API error behavior, caching, or upload and mutation operations. The documented server focuses on searching and retrieving GIF data; it does not describe GIF creation, editing, or publishing.

The available rating filters are limited to g, pg, pg-13, and r. Search and trending result counts are capped at 50 per request, with pagination available through the offset parameter. The magarcia/mcp-server-giphy MCP server is licensed under MIT.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Server Giphy

magarcia/mcp-server-giphy is an MCP server that connects AI clients to the Giphy API. Its main tools search GIFs by query, retrieve a random GIF with optional tag filtering, and return trending GIFs. Responses include URLs, titles, identifiers, image dimensions, formats, and other available metadata for agent workflows.

Run it with npx using `npx -y mcp-server-giphy`, or install the repository dependencies with `npm install` and build it with `npm run build`. The server also documents `npm start` for launching the built project and requires a Giphy API key.

Set the `GIPHY_API_KEY` environment variable to a key created through the Giphy Developer dashboard. You can place it in a `.env` file or provide it in the MCP client's environment configuration.

Yes, magarcia/mcp-server-giphy works with Claude Desktop through an MCP configuration entry. Set its command to `npx`, pass `-y` and `mcp-server-giphy` as arguments, and provide `GIPHY_API_KEY` in the entry's environment.

It supports rating filters on search, random, and trending requests; search also accepts a language, random retrieval accepts a tag, and search and trending retrieval accept limit and offset values. Supported ratings are `g`, `pg`, `pg-13`, and `r`.

Related MCP servers

All in Other Tools and Integrations All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Server Giphy AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/magarcia-mcp-server-giphy?style=directory)](https://allmcps.com/mcp/magarcia-mcp-server-giphy)
HTML Embed
<a href="https://allmcps.com/mcp/magarcia-mcp-server-giphy"><img src="https://allmcps.com/api/badge/magarcia-mcp-server-giphy?style=directory" alt="MCP Server Giphy on AllMCPs" /></a>