🤖 For AI Assistants

MCP Server

Let your AI assistant explore the podcast

My Weird Prompts exposes a public MCP (Model Context Protocol) server, allowing AI assistants like Claude to search episodes, retrieve transcripts, and discover content directly.

Quick Start

MCP Endpoint
https://myweirdprompts.com/api/mcp

Send POST requests with JSON-RPC 2.0 format. GET requests return server documentation.

Available Tools

📋

list_episodes

List podcast episodes with optional filtering by tag. Supports pagination.

limit - Max episodes (default: 10) offset - Skip N episodes tag - Filter by tag
🎙️

get_episode

Get full episode details including transcript and show notes.

slug - Episode slug (required)
🔍

search_episodes

Full-text search across titles, descriptions, and transcripts.

query - Search text (required) limit - Max results (default: 10)
🎲

get_random_episode

Get a random episode for serendipitous discovery. No parameters needed.

📊

get_stats

Get podcast statistics: total episodes, available tags, and latest content.

Usage Examples

Initialize Connection

{
  "jsonrpc": "2.0",
  "method": "initialize",
  "id": 1
}

List Available Tools

{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "id": 2
}

Search Episodes

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_episodes",
    "arguments": {
      "query": "artificial intelligence"
    }
  },
  "id": 3
}

Get a Specific Episode

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_episode",
    "arguments": {
      "slug": "supercomputing-exascale-home-build"
    }
  },
  "id": 4
}

Rate Limits

30 requests per minute
429 status when exceeded

Rate limiting protects the service from abuse. If you need higher limits for a specific use case, get in touch.

REST API

Prefer a traditional REST API? These endpoints are also available:

GET /api/episodes.json List episodes with filtering
GET /api/episodes/[slug].json Get single episode
GET /feed.xml Podcast RSS feed

What is MCP?

Model Context Protocol (MCP) is an open protocol that allows AI assistants to connect to external data sources and tools. By exposing this MCP server, My Weird Prompts becomes queryable by any MCP-compatible AI assistant.

This means you can ask your AI assistant things like:

  • "Find My Weird Prompts episodes about technology"
  • "Get the transcript from the latest episode"
  • "What topics does My Weird Prompts cover?"
  • "Give me a random episode to listen to"