`trending_gifs`

Pack: giphy · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/trending_gifs for the schema, then POST the same URL with its arguments for the data.

Get currently trending GIFs on Giphy. Returns title, URL, rating, and multiple image sizes.

Parameters

Name	Type	Required	Description
`limit`	number	no	Number of results to return (1–25, default 10)

Example call

Arguments

{
  "limit": 10
}

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":"trending_gifs","arguments":{"limit":10}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('trending_gifs', {
  "limit": 10
});

Response shape

Always returns: count, gifs

Field	Type	Description
`count`	number	Number of trending GIFs returned
`gifs`	array	Array of trending GIF objects

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of trending GIFs returned"
    },
    "gifs": {
      "type": "array",
      "items": {
        "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"
        ]
      },
      "description": "Array of trending GIF objects"
    }
  },
  "required": [
    "count",
    "gifs"
  ]
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the giphy pack

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

See Getting Started for client-specific install steps.

trending_gifs