A Model Context Protocol (MCP) server that empowers AI agents to search and retrieve lively GIFs from Giphy, enhancing chat and documentation experiences.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"giphy-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Giphy MCP Server [](https://github.com/Szatek/giphy-mcp-server/actions/workflows/ci.yml) [](https://badge.fury.io/py/giphy-mcp) An MCP (Model Context Protocol) server that allows AI agents to search and retrieve GIFs using the Giphy API. This provides a rich way for agents to express humor, reactions, or find relevant visual context.  ## Prerequisites - Python 3.10+ - A Giphy API Key. You can get a free API key at the [Giphy Developer Portal](https://developers.giphy.com/). ## Installation For general use, install the package via pip: ```bash pip install giphy-mcp ``` For development: 1. Clone the repository: ```bash git clone https://github.com/Szatek/giphy-mcp-server.git cd giphy-mcp-server ``` 2. Create a virtual environment and install in editable mode: ```bash python -m venv venv # On Windows .\venv\Scripts\activate # On Linux/macOS source venv/bin/activate pip install -e ".[dev]" ``` ## Usage The Giphy MCP Server is designed to be run as a standard IO transport process, which AI agents and MCP clients can spawn. To start the server: ```bash giphy-mcp run ``` To see the help menu and configuration options: ```bash giphy-mcp help ``` ## Configuration The server requires a Giphy API Key to function. It reads this from the `GIPHY_API_KEY` environment variable. You can configure this by: 1. Creating a `.env` file in the project root: ```env GIPHY_API_KEY=your_api_key_here ``` 2. Or by passing it directly via your MCP client's configuration. ## Available Tools - `search_gifs` - **Description**: Search for GIFs using the Giphy API. - **Parameters**: - `query` (stri…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.