Skip to content
MCP server

Tenor

MCP server giving AI clients access to Tenor GIF and sticker search, trending terms

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/tenor/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tenor": {
      "url": "https://gateway.pipeworx.io/tenor/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers