
Tenor
MCP server giving AI clients access to Tenor GIF and sticker search, trending terms
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Tenor
Tenor is a freemium MCP server for web search and scraping. It can run locally on your machine or as a hosted remote server.
The Pipeworx gateway exposes Google's Tenor v2 GIF API as a set of MCP tools. An assistant can search GIFs and stickers by keyword, pull the editorially featured collection, list browse categories, fetch specific posts by ID to refresh their media URLs, and get trending or autocomplete phrases for building search boxes.
Connection is through a hosted streamable-HTTP endpoint or a local npx bridge. Calls work anonymously at a small daily cap; a free Pipeworx key raises the cap, and a personal Tenor key can be passed per call so upstream quota is used directly. The README notes that the endpoint also lists shared gateway meta-tools such as ask_pipeworx alongside the Tenor tools.
The server suits developers building chat, messaging or content features that need GIF pickers, and agents that need to find reaction media.
Install
Run in a terminal
claude mcp add --transport http tenor https://gateway.pipeworx.io/tenor/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/tenor/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"tenor": {
"url": "https://gateway.pipeworx.io/tenor/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tenor": {
"type": "http",
"url": "https://gateway.pipeworx.io/tenor/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tenor": {
"serverUrl": "https://gateway.pipeworx.io/tenor/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tenor": {
"type": "http",
"url": "https://gateway.pipeworx.io/tenor/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- search
- GIF and sticker search by keyword.
- featured
- Fetch Tenor's editorially featured GIFs.
- categories
- Return GIF browse categories with previews.
- search_suggestions
- Query suggestions for a partial search string.
- autocomplete
- Autocomplete completions for a partial search term.
- trending_terms
- Trending GIF and sticker keywords.
- posts
- Fetch specific GIFs or stickers by post ID.
What it does
- Keyword GIF search
- Searches Tenor's GIF and sticker library with locale, content filter, aspect ratio and pagination options.
- Featured and categories
- Returns Tenor's editorially featured GIFs and browse categories with preview images.
- Search autocomplete
- Provides query suggestions and popularity-ordered completions for partial search terms.
- Trending terms
- Lists keywords people are currently typing to find reaction and meme GIFs.
- Post lookup by ID
- Re-resolves media URLs and metadata for specific GIF or sticker post IDs.
- Flexible connection options
- Runs over a hosted HTTP endpoint or a local stdio bridge started with npx.
Good for
- Adding a GIF picker with search and featured content to a chat app
- Building autocomplete suggestions for a GIF search box
- Letting an AI assistant find a reaction GIF to send in a conversation
- Refreshing stale media URLs for GIFs returned by an earlier search
Pricing
Freemium, from $49 a month
Free anonymous and free account tiers; paid credits and subscriptions for higher usage.
Prices change. Check pipeworx.io before you buy.
Tenor FAQ
Do I need an API key?
Calls work anonymously with a daily cap. The README says a free Pipeworx key raises the cap, and a Tenor key can be passed per call via _apiKey.
What does the free Pipeworx tier allow?
The pricing page lists 200 tool calls a day for registered free accounts and 50 a day for anonymous callers.
Which tools does the endpoint expose?
The README lists seven Tenor tools: search, featured, categories, search_suggestions, autocomplete, trending_terms and posts. The endpoint also includes shared Pipeworx meta-tools.
Is Tenor free?
Tenor has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.
How do I add Tenor to Claude Code?
Run this command in your terminal: claude mcp add --transport http tenor https://gateway.pipeworx.io/tenor/mcp
What are the best alternatives to Tenor?
The closest alternatives to Tenor are Google Trends, Google Trends, Google_search_console, TwexAPI and Rss2json.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.