`search_episodes`

Pack: rick-and-morty · Endpoint: https://gateway.pipeworx.io/rick-and-morty/mcp

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

Search Rick and Morty episodes by name or episode code (S01E03 style). Returns episode metadata including air date, character list, and ID.

Parameters

Name	Type	Required	Description
`name`	string	no	Episode name to search for (partial match).
`episode`	string	no	Episode code (e.g., “S01E03”).
`page`	number	no	Page number (1-based, default 1).

Example call

Arguments

{
  "name": "Pilot"
}

curl

curl -X POST https://gateway.pipeworx.io/rick-and-morty/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_episodes","arguments":{"name":"Pilot"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search_episodes', {
  "name": "Pilot"
});

More examples

{
  "episode": "S01E03"
}

Response shape

Field	Type	Description
`found`	boolean	Whether any episodes matched the search
`count`	number	Number of matching episodes
`episodes`	array	List of matching episodes
`hint`	string	Hint message when no results found
`total`	number	Total number of matching episodes
`pages`	number	Total number of pages
`page`	number	Current page number
`has_more`	boolean	Whether there are more pages

Full JSON Schema

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean",
      "description": "Whether any episodes matched the search"
    },
    "count": {
      "type": "number",
      "description": "Number of matching episodes"
    },
    "episodes": {
      "type": "array",
      "description": "List of matching episodes",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "description": "Episode ID"
          },
          "name": {
            "type": "string",
            "description": "Episode title"
          },
          "code": {
            "type": "string",
            "description": "Episode code (e.g., S01E03)"
          },
          "air_date": {
            "type": "string",
            "description": "Air date"
          },
          "character_count": {
            "type": "number",
            "description": "Number of characters in episode"
          },
          "character_ids": {
            "type": "array",
            "items": {
              "type": "number"
            },
            "description": "Character IDs"
          },
          "url": {
            "type": "string",
            "description": "API URL"
          }
        }
      }
    },
    "hint": {
      "type": "string",
      "description": "Hint message when no results found"
    },
    "total": {
      "type": "number",
      "description": "Total number of matching episodes"
    },
    "pages": {
      "type": "number",
      "description": "Total number of pages"
    },
    "page": {
      "type": "number",
      "description": "Current page number"
    },
    "has_more": {
      "type": "boolean",
      "description": "Whether there are more pages"
    }
  }
}

Connect

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

{
  "mcpServers": {
    "rick-and-morty": {
      "url": "https://gateway.pipeworx.io/rick-and-morty/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_episodes