# Tenor MCP > Tenor MCP Server lets your agent search, discover, and retrieve millions of GIFs and stickers from Tenor. Need a reaction GIF for a social media post? Use `search_gifs` with powerful filters. Want to see what's currently viral? Call `get_trending_terms`. This server gives your AI client direct access to the world’s largest visual library, letting you find exactly the right GIF or sticker without leaving your chat window. ## Overview - **Category:** image-video - **Price:** Free - **Tags:** gifs, stickers, memes, visual-search, tenor ## Description This server lets your agent tap into Tenor's whole library. It connects millions of GIFs and stickers directly to your AI client, so you don't have to leave your chat window to find the perfect visual for a post or a message. Your agent gives you direct access to a massive visual archive. **Searching Specific Content** If you know what you want, `search_gifs` runs a full query across Tenor’s library. You just give it keywords and filters, and the server returns results that match your criteria. But what if your search is too broad? Don't sweat it. Your agent can first run `get_autocomplete`. If you type 'catt', for instance, it suggests alternatives like 'cat memes' or 'cute kitten'. Even better, if your initial query feels vague, call `get_search_suggestions`; this pulls a list of related keywords that will narrow down your results before you even hit enter. When you need something super specific and already have the ID number—say, it’s GIF #12345—you use `get_posts`. That tool fetches all the metadata and posts associated with that unique GIF ID. **Discovering What's Hot Right Now** You don't always know what you need. Sometimes you just want to see what everyone else is talking about. For that, your agent uses `get_trending_terms`. It pulls the most popular or currently trending keywords on Tenor right now—you get a real-time pulse check on what people are searching for. You also wanna see what Tenor itself is pushing? Call `get_featured_gifs`. This tool retrieves the current set of GIFs that Tenor is globally highlighting as popular content. If you're trying to browse by vibe, not by keyword, your agent calls `list_categories`. It returns a clean, structured list of all available GIF categories—stuff like 'Nature', 'Funny', or 'Reactions'—so you know exactly what collections exist to search through. **Tracking and Logging Actions** The server isn't just for finding stuff; it keeps track. When your user explicitly selects and shares a specific GIF, `register_share` logs that event. This lets you monitor which content is actually performing well or getting shared by the community. All of this functionality means you get more than just search results; you get context, suggestions, trending data, and tracking on one server. You use your agent to run all these checks—whether it's filtering down millions of potential visuals using `search_gifs` and refining that initial thought process with `get_autocomplete`, or checking the cultural pulse by calling `get_trending_terms`. You control the entire flow, getting precise data points every time you need a visual for your chat message. ## Tools ### get_autocomplete Suggests alternative words when you type a partial search term. ### list_categories Returns a structured list of all available GIF categories (e.g., 'Funny', 'Nature'). ### get_featured_gifs Retrieves the current set of GIFs that Tenor is globally promoting or featuring. ### get_posts Fetches specific GIF metadata and posts using their unique ID number. ### register_share Logs an event when your user explicitly selects and shares a specific GIF. ### get_search_suggestions Provides a list of better, related search terms for a general query you submit. ### search_gifs Runs a full search across Tenor's library to find GIFs based on keywords and filters. ### get_trending_terms Gathers the most popular or currently trending keywords on Tenor. ## Prompt Examples **Prompt:** ``` Search for funny 'victory dance' GIFs on Tenor. ``` **Response:** ``` I've found several 'victory dance' GIFs for you. Here are the top results, including a celebratory Carlton dance and a joyful animated character. Which one would you like to use? ``` **Prompt:** ``` What are the trending search terms on Tenor right now? ``` **Response:** ``` The current trending terms on Tenor include 'Monday motivation', 'happy birthday', 'shocked face', and 'congratulations'. Would you like to see GIFs for any of these? ``` **Prompt:** ``` Give me some search suggestions related to 'coffee'. ``` **Response:** ``` Based on 'coffee', here are some suggested search terms: 'morning coffee', 'coffee addict', 'iced coffee', and 'need coffee'. Should I search for one of these instead? ``` ## Capabilities ### Search for specific visuals Your agent executes a search query and returns relevant GIF results matching your criteria. ### Discover trending topics Retrieves the current top-performing or most searched terms on Tenor right now. ### Get content suggestions Provides alternative search keywords and autocomplete options when your initial query is too vague. ### List available categories Pulls a structured list of GIF categories (e.g., 'Reactions', 'Memes') so you know what's out there to search for. ### Get featured content feeds Retrieves the current global set of GIFs that Tenor is highlighting as trending or popular. ## Use Cases ### Responding to a client query about company culture A community manager needs to reply to a complaint with a lighthearted, empathetic GIF. Instead of searching general terms, they tell their agent: 'Find a sympathetic or laughing reaction GIF.' The agent uses `search_gifs` and filters the results by mood, delivering an immediate visual response. ### Brainstorming marketing content for Q4 A content creator is planning holiday posts. They ask their agent: 'What are people talking about right now?' The agent calls `get_trending_terms`, revealing popular concepts like 'Black Friday' or 'Holiday Cheer,' giving the creator a list of fresh topics to build campaigns around. ### Building an internal knowledge chatbot A developer is building a help bot. When a user asks about a specific feature, the agent doesn't just answer with text; it uses `list_categories` and then `search_gifs` to pull a visual example GIF of that feature in action, making instructions clearer. ### Preparing for an international launch A global marketing team needs visuals. They ask the agent: 'What are people searching for globally this week?' The agent calls `get_trending_terms` and flags high-interest, universal concepts, helping them tailor their visual assets across different regions. ## Benefits - Find the perfect reaction GIF instantly. Instead of guessing keywords, use `get_search_suggestions` to narrow your query until you find exactly what you need for a chat response or article caption. - Never miss a viral trend. By calling `get_trending_terms`, your agent surfaces currently hot topics and GIFs, keeping your content fresh and relevant without manual research. - Save time building apps with structured data. Use `list_categories` to get a clean list of available themes (like 'Sports' or 'Food') so you can build dedicated search paths for specific types of media. - Retrieve specific assets by ID. If you already have a link or know the GIF ID, use `get_posts` to pull that exact piece of content without re-searching the whole library. - Keep your workflow moving. By integrating visual searches into your agent, you eliminate the need to switch tabs to Tenor's website every time you need an image. ## How It Works The bottom line is, it lets your AI client use visual search on Tenor without you ever leaving your chat interface. 1. First, subscribe to the server and provide your personal Tenor API Key within your AI client's settings. 2. Next, you ask your agent for a GIF—for example: 'Show me an animated cat dancing.' 3. The agent translates that request into a tool call using `search_gifs` and presents the results directly to you. ## Frequently Asked Questions **How do I start searching for GIFs using `search_gifs`?** You simply ask your agent to search for content—for example, 'Search for epic failure GIFs.' The agent executes the tool call and returns relevant results. **What does `get_trending_terms` do?** `get_trending_terms` pulls a list of currently popular search keywords. This helps you find out what topics are viral right now, giving your content ideas instantly. **Why should I use `list_categories` instead of searching?** If you're unsure of the exact keyword, running `list_categories` shows you the full scope—like 'Memes' or 'Reactions.' This helps guide your search and gives you a better starting point. **Is there a tool to find specific GIFs by ID? What about `get_posts`?** `get_posts` lets you retrieve content using its unique ID. If someone sends you a link or tells you the GIF's code, this is how your agent pulls it up. **How do I refine a partial query using `get_autocomplete`?** It returns suggested completions for a search term you haven't finished typing. Use this tool to see possible keywords immediately, allowing you to narrow down your focus before executing the full search. **What is the purpose of `get_featured_gifs`?** This tool retrieves a list of Tenor's globally featured GIFs. It’s useful when you want to see top-level, curated content without needing specific search terms or categories. **How do I track user interest with `register_share`?** It logs the event whenever a user selects or shares a GIF within your application. You use this data to measure which visual assets are most popular among your specific audience. **If my initial search fails, how do I expand it using `get_search_suggestions`?** The tool provides alternative keywords related to your query. This helps you expand your conceptual scope and find relevant GIFs even if your original terminology was too narrow. **Can I filter GIF results by safety or content rating?** Yes! The `search_gifs` and `get_featured_gifs` tools support a `contentfilter` parameter. You can set it to 'off', 'low', 'medium', or 'high' to ensure the results are appropriate for your audience. **How do I find out what people are currently searching for on Tenor?** You can use the `get_trending_terms` tool. It returns a list of the most popular search terms currently trending on the platform, helping you stay relevant with current memes and topics. **Is it possible to retrieve a specific GIF if I already have its ID?** Absolutely. Use the `get_posts` tool and provide a comma-separated list of GIF IDs. The agent will fetch the full metadata and media formats for those specific items.