# Tenor

> Tenor is a freemium MCP server for web search and scraping. MCP server giving AI clients access to Tenor GIF and sticker search, trending terms. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/tenor
- **Repository:** https://github.com/pipeworx-io/mcp-tenor
- **MCP Registry name:** io.github.pipeworx-io/tenor
- **Categories:** [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tenor https://gateway.pipeworx.io/tenor/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/tenor/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tenor": {
      "url": "https://gateway.pipeworx.io/tenor/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tenor": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/tenor/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tenor": {
      "serverUrl": "https://gateway.pipeworx.io/tenor/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tenor": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/tenor/mcp"
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Google Trends](https://ai-powered.com/mcp/google-trends-3): Google Trends is a freemium MCP server for web search and scraping.
- [Google Trends](https://ai-powered.com/mcp/google-trends-5): Google Trends is an MCP server for web search and scraping.
- [Google_search_console](https://ai-powered.com/mcp/google-search-console-8): Google_search_console is a freemium MCP server for web search and scraping.
- [TwexAPI](https://ai-powered.com/mcp/twexapi): TwexAPI is a freemium MCP server for web search and scraping.
- [Rss2json](https://ai-powered.com/mcp/rss2json): Rss2json is a freemium MCP server for web search and scraping.
- [Zenserp MCP by usefulapi](https://ai-powered.com/mcp/zenserp-mcp-by-usefulapi): Zenserp MCP by usefulapi is a freemium MCP server for design and media.
- [Unsplash](https://ai-powered.com/mcp/unsplash): Unsplash is a freemium MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/tenor
