`search_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/search_gifs for the schema, then POST the same URL with its arguments for the data.

Search Giphy for GIFs by keyword. Returns title, URL, rating, and multiple image sizes.

Parameters

Name	Type	Required	Description
`query`	string	yes	Search query, e.g. “funny cats” or “celebration”
`limit`	number	no	Number of results to return (1–25, default 10)

Example call

Arguments

{
  "query": "funny cats"
}

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":"search_gifs","arguments":{"query":"funny cats"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search_gifs', {
  "query": "funny cats"
});

More examples

{
  "query": "celebration",
  "limit": 15
}

Response shape

Always returns: total, count, gifs

Field	Type	Description
`total`	number	Total count of matching GIFs available
`count`	number	Number of GIFs returned in this response
`gifs`	array	Array of GIF objects

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Total count of matching GIFs available"
    },
    "count": {
      "type": "number",
      "description": "Number of GIFs returned in this response"
    },
    "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 GIF objects"
    }
  },
  "required": [
    "total",
    "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.

search_gifs