`random_gif`

Pack: giphy · Endpoint: https://gateway.pipeworx.io/giphy/mcp

Get a random GIF, optionally filtered by tag (e.g., “cats”). Returns title, URL, rating, and image URLs.

Parameters

Name	Type	Required	Description
`tag`	string	no	Optional tag to filter by, e.g. “dogs” or “anime”

Example call

Arguments

{
  "tag": "dogs"
}

curl

curl -X POST https://gateway.pipeworx.io/giphy/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"random_gif","arguments":{"tag":"dogs"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('random_gif', {
  "tag": "dogs"
});

Response shape

Always returns: id, title, url, rating, gif_url, fixed_height_url, downsized_url, width, height

Field	Type	Description
`id`	string	GIF ID
`title`	string	GIF title
`url`	string	GIF page URL on Giphy
`rating`	string	Content rating (e.g., ‘g’, ‘pg’, ‘pg-13’, ‘r’)
`gif_url`	string	Original GIF URL
`fixed_height_url`	string	Fixed-height GIF URL
`downsized_url`	string	Downsized GIF URL
`width`	number	Original GIF width in pixels
`height`	number	Original GIF height in pixels

Full JSON Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "GIF ID"
    },
    "title": {
      "type": "string",
      "description": "GIF title"
    },
    "url": {
      "type": "string",
      "description": "GIF page URL on Giphy"
    },
    "rating": {
      "type": "string",
      "description": "Content rating (e.g., 'g', 'pg', 'pg-13', 'r')"
    },
    "gif_url": {
      "type": "string",
      "description": "Original GIF URL"
    },
    "fixed_height_url": {
      "type": "string",
      "description": "Fixed-height GIF URL"
    },
    "downsized_url": {
      "type": "string",
      "description": "Downsized GIF URL"
    },
    "width": {
      "type": "number",
      "description": "Original GIF width in pixels"
    },
    "height": {
      "type": "number",
      "description": "Original GIF height in pixels"
    }
  },
  "required": [
    "id",
    "title",
    "url",
    "rating",
    "gif_url",
    "fixed_height_url",
    "downsized_url",
    "width",
    "height"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "giphy": {
      "url": "https://gateway.pipeworx.io/giphy/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

random_gif