Server definition

Hash: sha256:47e8d0fa7c55d278ffbdb2ccfdcc5f0b1d7357b6e6540408fc721f9553a72176
What it is: What a remote MCP server returned when asked what it offers: 25 tools

The blob, as servednamed by its sha256

{
  "instructions": "Agent-facing podcast transcript library. Always cite episode_id in synthesis. For paid actions (start_transcription, transcribe_url, generate_lesson) confirm cost with the user before invoking — credit gates enforce server-side but the user should see the cost choice explicitly.",
  "tools": [
    {
      "description": "Open an interactive episode picker (card grid with thumbnails) for the user to pick an episode to read. On hosts that render MCP Apps the grid is clickable; everywhere else a markdown table is returned. Optional query filters by title/host.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "limit": {
            "default": 12,
            "maximum": 40,
            "minimum": 1,
            "type": "integer"
          },
          "query": {
            "description": "Optional title/host filter",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "browse_episodes",
      "outputSchema": null
    },
    {
      "description": "Generate a structured AI lesson (summary, key takeaways, sections) from a completed transcription. Requires the episode to have transcription_status \"completed\". Consumes 1 credit, or one unit of subscription quota, on first generation for an episode; subsequent calls return the cached lesson at no cost.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "episode_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "episode_id"
        ],
        "type": "object"
      },
      "name": "generate_lesson",
      "outputSchema": null
    },
    {
      "description": "Turn an already-generated lesson into a LinkedIn-ready share post. Pass lesson_id directly OR episode_id (uses the most recent lesson generated by the caller for that episode). Lesson must exist — chain after generate_lesson if needed.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "episode_id": {
            "format": "uuid",
            "type": "string"
          },
          "lesson_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "generate_linkedin_post",
      "outputSchema": null
    },
    {
      "description": "Fetch full metadata for one episode including transcription_status and lesson_generation_status. Tells you whether get_transcription is ready or you need to transcribe first: start_transcription(episode_id) for an in-library episode (inherits its existing show/artwork/feed linkage automatically) or transcribe_url(audio_url, title, feed_id, podcast_name) for a URL not yet in the library.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "episode_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "episode_id"
        ],
        "type": "object"
      },
      "name": "get_episode_details",
      "outputSchema": null
    },
    {
      "description": "Get the caller's episode-access usage stats — how many episodes they've transcribed/read this billing period.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "limit": {
            "default": 20,
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "offset": {
            "default": 0,
            "minimum": 0,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "get_episode_usage",
      "outputSchema": null
    },
    {
      "description": "Fetch the full body of one AI-generated lesson (title, summary, key takeaways, structured sections). Use to retrieve prior synthesis — for creating a NEW one call generate_lesson.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "lesson_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "lesson_id"
        ],
        "type": "object"
      },
      "name": "get_lesson_content",
      "outputSchema": null
    },
    {
      "description": "Fetch full metadata for one podcast in the PodLearn library, including its episode count. The podcast must already be in the local DB (source=local in search_podcasts results).",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "podcast_id": {
            "description": "Local podcast id",
            "type": "integer"
          }
        },
        "required": [
          "podcast_id"
        ],
        "type": "object"
      },
      "name": "get_podcast_details",
      "outputSchema": null
    },
    {
      "description": "List the caller's saved/bookmarked episodes and lessons.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {},
        "type": "object"
      },
      "name": "get_saved_items",
      "outputSchema": null
    },
    {
      "description": "Get the caller's subscription plan + active/expired status + period end.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {},
        "type": "object"
      },
      "name": "get_subscription_status",
      "outputSchema": null
    },
    {
      "description": "Fetch transcript text for a completed episode. PAGINATED — returns up to 120,000 characters per call (Claude.ai/Desktop caps a tool result at ~150k chars). Most transcripts fit in one call; only very long episodes page. If the response has `has_more: true`, call again with `offset: <next_offset>`. For focused look-up (a topic, quote, timestamp) prefer search_transcription.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "episode_id": {
            "format": "uuid",
            "type": "string"
          },
          "max_chars": {
            "description": "Max characters to return this call (default & max 120000).",
            "maximum": 120000,
            "minimum": 2000,
            "type": "integer"
          },
          "offset": {
            "description": "Character offset to start from (default 0). Use next_offset from a prior page.",
            "minimum": 0,
            "type": "integer"
          }
        },
        "required": [
          "episode_id"
        ],
        "type": "object"
      },
      "name": "get_transcription",
      "outputSchema": null
    },
    {
      "description": "Fetch timestamped transcript segments. Use when the user wants timestamps — \"jump to where they discuss X\", chapter boundaries, durations of specific parts.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "episode_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "episode_id"
        ],
        "type": "object"
      },
      "name": "get_transcription_segments",
      "outputSchema": null
    },
    {
      "description": "Get the caller's remaining transcription credits.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {},
        "type": "object"
      },
      "name": "get_user_credits",
      "outputSchema": null
    },
    {
      "description": "List episodes already in the local DB for a specific podcast. Requires podcast_id (use search_podcasts first if you only have a name). For cross-podcast search use search_episodes; for canonical PodcastIndex listings use list_feed_episodes.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "limit": {
            "default": 20,
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "offset": {
            "default": 0,
            "minimum": 0,
            "type": "integer"
          },
          "podcast_id": {
            "description": "Local podcast_id from search_podcasts",
            "type": "integer"
          },
          "status": {
            "enum": [
              "completed",
              "processing",
              "failed",
              "not_started"
            ],
            "type": "string"
          }
        },
        "required": [
          "podcast_id"
        ],
        "type": "object"
      },
      "name": "list_episodes",
      "outputSchema": null
    },
    {
      "description": "Fetch the canonical episode list for a podcast directly from PodcastIndex (the upstream RSS index). NO COST — pure discovery. Each episode is enriched with `in_library`, `episode_id` (if already ingested), and `transcription_status`. For episodes you want to ingest: call transcribe_url(audio_url, title, feed_id, podcast_name) — passing feed_id/podcast_name lands the episode under its real show. For episodes already in_library, use start_transcription(episode_id) instead.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "before": {
            "description": "Unix seconds — published BEFORE (pagination)",
            "type": "integer"
          },
          "feed_id": {
            "description": "PodcastIndex feed_id (the `id` from a search_podcasts result)",
            "type": "string"
          },
          "max": {
            "default": 20,
            "maximum": 200,
            "minimum": 1,
            "type": "integer"
          },
          "since": {
            "description": "Unix seconds — published AFTER",
            "type": "integer"
          }
        },
        "required": [
          "feed_id"
        ],
        "type": "object"
      },
      "name": "list_feed_episodes",
      "outputSchema": null
    },
    {
      "description": "List the calling user's saved AI-generated lessons.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "limit": {
            "default": 20,
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "offset": {
            "default": 0,
            "minimum": 0,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "list_lessons",
      "outputSchema": null
    },
    {
      "description": "List podcasts already in the PodLearn library, optionally filtered by category. Returns most-recently-added first. For discovery beyond the library use search_podcasts.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "category": {
            "description": "Filter by category (e.g. \"Technology\")",
            "type": "string"
          },
          "limit": {
            "default": 20,
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "offset": {
            "default": 0,
            "minimum": 0,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "list_podcasts",
      "outputSchema": null
    },
    {
      "description": "Permanently remove a saved/bookmarked episode or lesson from the caller's collection. The saved_item_id comes from get_saved_items.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "saved_item_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "saved_item_id"
        ],
        "type": "object"
      },
      "name": "remove_saved_item",
      "outputSchema": null
    },
    {
      "description": "Bookmark an episode or lesson for the caller.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "item_id": {
            "description": "UUID of the episode or lesson to save",
            "type": "string"
          },
          "item_type": {
            "enum": [
              "episode",
              "lesson"
            ],
            "type": "string"
          }
        },
        "required": [
          "item_type",
          "item_id"
        ],
        "type": "object"
      },
      "name": "save_item",
      "outputSchema": null
    },
    {
      "description": "Cross-podcast episode search by title/description AND parent podcast name/author. Returns local episodes only — for podcasts discoverable on PodcastIndex that aren't yet ingested, use list_feed_episodes instead. `status: \"transcribed\"` filters to ready-to-read; `status: \"untranscribed\"` to available-to-transcribe.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "limit": {
            "default": 20,
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "offset": {
            "default": 0,
            "minimum": 0,
            "type": "integer"
          },
          "query": {
            "description": "Topic, keyword, or host name",
            "type": "string"
          },
          "status": {
            "enum": [
              "transcribed",
              "untranscribed",
              "completed",
              "processing",
              "failed",
              "not_started"
            ],
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "type": "object"
      },
      "name": "search_episodes",
      "outputSchema": null
    },
    {
      "description": "Search PodLearn library AND PodcastIndex.org (4M+ podcasts) by keyword. Also resolves Spotify/Apple Podcasts URLs. Returns rows tagged with `source: local|podcastindex|spotify`. First move when the user names a podcast/host but you don't have its id.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "query": {
            "description": "Search keywords or a podcast URL",
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "type": "object"
      },
      "name": "search_podcasts",
      "outputSchema": null
    },
    {
      "description": "Keyword search WITHIN a single episode's transcript. Returns matching chunks with surrounding context. Use instead of get_transcription when the user asked about a specific topic — server does this faster + cheaper on context.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "episode_id": {
            "format": "uuid",
            "type": "string"
          },
          "query": {
            "description": "Topic, phrase, or speaker name",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "episode_id",
          "query"
        ],
        "type": "object"
      },
      "name": "search_transcription",
      "outputSchema": null
    },
    {
      "description": "Discover YouTube videos by topic/keyword across all of YouTube. Use when the user wants to learn from a talk/interview/lecture and has no URL — especially when search_podcasts / search_episodes find nothing (much long-form content is YouTube-first). NO COST: pure discovery. Returns rows with a ready-to-transcribe `url`; to ingest one, confirm cost and call transcribe_url(url, title).",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "max": {
            "maximum": 25,
            "minimum": 1,
            "type": "integer"
          },
          "query": {
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "type": "object"
      },
      "name": "search_youtube",
      "outputSchema": null
    },
    {
      "description": "Kick off transcription on an episode ALREADY in the library. Use only when the episode row exists and transcription_status is not \"completed\". Inherits the episode's existing show, artwork, and feed linkage automatically — no need to pass podcast context. For audio not yet in the library, use transcribe_url. COSTS 1 CREDIT (or subscription quota).",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "episode_id": {
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "episode_id"
        ],
        "type": "object"
      },
      "name": "start_transcription",
      "outputSchema": null
    },
    {
      "description": "Bulk/season transcription — kick off transcription for up to `max` (cap 25) not-yet-transcribed episodes of a podcast feed in ONE call. Pass the `feed_id` from search_podcasts / list_feed_episodes. Already-transcribed episodes are skipped free. COSTS 1 credit per newly enqueued episode (or subscription quota) — CONFIRM the cost with the user first. Enqueue-and-poll: returns each enqueued episode_id; poll get_episode_details until transcription_status is \"completed\".",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "before": {
            "description": "Optional unix-seconds; only episodes published BEFORE (page back)",
            "type": "integer"
          },
          "feed_id": {
            "description": "PodcastIndex feed id (from a search_podcasts / list_feed_episodes result)",
            "type": "string"
          },
          "max": {
            "description": "Max episodes to enqueue (default 10, cap 25)",
            "maximum": 25,
            "minimum": 1,
            "type": "integer"
          },
          "since": {
            "description": "Optional unix-seconds; only episodes published AFTER",
            "type": "integer"
          }
        },
        "required": [
          "feed_id"
        ],
        "type": "object"
      },
      "name": "transcribe_feed",
      "outputSchema": null
    },
    {
      "description": "Ingest and transcribe an EXTERNAL / arbitrary audio URL — a URL the user pasted, or audio not reachable through the index. Creates a STANDALONE episode row. If the episode is already in the library (it has an episode_id), prefer start_transcription(episode_id) instead — it inherits the episode's existing show, artwork, and feed linkage automatically. Consumes 1 transcription credit, or one unit of subscription quota; the credit is refunded automatically if transcription fails. Pass feed_id / podcast_name when you already know the parent show (e.g. from search_podcasts or list_feed_episodes) so the episode lands under its real show instead of appearing as unidentified \"External audio\". Returns the new episode_id. Transcription is asynchronous on the fallback path — poll get_episode_details until transcription_status is \"completed\".",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "audio_url": {
            "description": "Direct audio URL (mp3, m4a, or platform URL)",
            "format": "uri",
            "type": "string"
          },
          "feed_id": {
            "description": "Optional: local podcasts.id / PodcastIndex feed id of the parent show, if known. Looked up only — never creates a show.",
            "type": "string"
          },
          "language": {
            "description": "BCP-47 hint (e.g. \"en\", \"he\"). Auto-detect if omitted.",
            "type": "string"
          },
          "podcast_id": {
            "description": "Existing parent podcast_id, if any",
            "type": "integer"
          },
          "podcast_name": {
            "description": "Optional: exact parent show title, if known and feed_id is unavailable. Matched only when it resolves to EXACTLY ONE existing show.",
            "type": "string"
          },
          "title": {
            "description": "Episode title — shown in the user's library",
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "audio_url",
          "title"
        ],
        "type": "object"
      },
      "name": "transcribe_url",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:47e8d0fa7c55d278ffbdb2ccfdcc5f0b1d7357b6e6540408fc721f9553a72176 | sha256sum