`search`

Pack: listen-notes · Endpoint: https://gateway.pipeworx.io/listen-notes/mcp

Search the Listen Notes podcast index across podcasts, individual episodes, curated lists, and people, with filters for type, language, genre ids, episode length, and date sorting. Returns matching podcast or episode records with title, publisher, description, audio URL, publish date, and the Listen Notes id used by the other tools in this pack. Answers which podcast or episode covers a topic, guest, or show name.

Parameters

Name	Type	Required	Description
`query`	string	yes
`type`	string	no	podcast \| episode \| curated \| person
`sort_by_date`	number	no	0 (relevance, default) \| 1 (date desc)
`language`	string	no
`len_min`	number	no
`len_max`	number	no
`genre_ids`	string	no	Comma-sep ids.
`offset`	number	no

Example call

Arguments

{
  "query": "true crime"
}

curl

curl -X POST https://gateway.pipeworx.io/listen-notes/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"true crime"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search', {
  "query": "true crime"
});

More examples

{
  "query": "machine learning",
  "type": "episode",
  "sort_by_date": 1,
  "language": "English",
  "len_min": 30,
  "len_max": 120
}

Response shape

Field	Type	Description
`count`	number	Total number of results
`total`	number	Total results available
`results`	array	Search results
`next_offset`	number	Offset for next page

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Total number of results"
    },
    "total": {
      "type": "number",
      "description": "Total results available"
    },
    "results": {
      "type": "array",
      "description": "Search results",
      "items": {
        "type": "object"
      }
    },
    "next_offset": {
      "type": "number",
      "description": "Offset for next page"
    }
  }
}

Connect

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

{
  "mcpServers": {
    "listen-notes": {
      "url": "https://gateway.pipeworx.io/listen-notes/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search