Giphy Integration for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Giphy MCP or direct API to search trending GIFs, fetch stickers, share animated content, and power conversational media—using simple natural language.
Giphy Logo
Gradient Top
Gradient Middle
Gradient Bottom
divider

Supported Tools

Tools
Giphy Analytics RegisterTool to register user interactions (view, click, send) with a GIF for analytics.
Emoji VariationsTool to fetch variations for a specific emoji.
Get GIF by IDTool to fetch GIF metadata by its unique ID.
Get GIFs by IDsTool to fetch metadata for multiple GIFs by their IDs.
Get Sticker by IDTool to fetch sticker metadata by its unique ID.
Get Stickers by IDsTool to fetch metadata for multiple stickers by their IDs.
GIPHY CategoriesTool to fetch a list of GIF categories on GIPHY.
GIPHY: Get Category by IDTool to fetch metadata for a GIF category by its unique ID.
GIPHY: Category GIFsTool to fetch GIFs associated with a specific GIF category.
GIPHY EmojiTool to fetch GIPHY emoji GIF objects.
Get Related TagsTool to fetch tags related to a specified tag.
GIPHY: Tag SearchTool to search GIPHY's tag library for autocomplete suggestions.
GIPHY Trending TagsTool to fetch the most popular search terms (tags) on GIPHY.
GIPHY Translate StickerTool to translate a term or phrase into a single sticker using GIPHY’s translation algorithm.
Get Trending StickersTool to fetch trending stickers.
Giphy Random GIFTool to fetch a random GIF from Giphy.
Giphy Random StickerTool to fetch a single random sticker.
GIPHY: Search GIFsTool to search GIPHY's GIF library.
GIPHY: Search StickersTool to search GIPHY's sticker library.
GIPHY: Random TagTool to fetch a single random tag from Giphy.
GIPHY Trending GIFsTool to fetch trending GIFs from GIPHY.
Giphy Upload GIFTool to upload a GIF or video file to GIPHY.

Connect Giphy MCP Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio claude-agent-sdk
Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
Initialize the Composio client and create a Tool Router session

Connect to AI Agent

python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Giphy tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Find trending cat GIFs for me')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
Use the MCP server with your AI agent

Connect Giphy API Tool with your Agent

Python
TypeScript

Install Composio

python
pip install composio_openai
Install the Composio SDK

Initialize Composio and Create Tool Router Session

python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
Import and initialize Composio client, then create a Tool Router session

Execute Giphy Tools via Tool Router with Your Agent

python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Find trending GIFs about happy birthday'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
Get tools from Tool Router session and execute Giphy actions with your Agent

Why Use Composio?

AI Native Giphy Integration

  • Supports both Giphy MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for searching GIFs, trending content, and stickers

Managed Auth

  • Built-in API key management and secure credential storage
  • Central place to manage and revoke Giphy API keys
  • Per user and per environment keys—no more hard-coded secrets

Agent Optimized Design

  • Tools tuned for GIF search, trending, and sticker endpoints
  • Comprehensive logs so you know which GIFs your agents fetch

Enterprise Grade Security

  • Fine-grained RBAC to control which agents and users can access Giphy
  • Scoped, least privilege access to search and content features
  • Full audit trail of all agent GIF and sticker activity

Frequently Asked Questions

Do I need my own developer credentials to use Giphy with Composio?

Yes, Giphy requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Used by agents from

Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
ASU
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.