Spoken is an MCP server published by io.github.spokenmd, hosted at spoken.md. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 8 tools, including search_podcasts, get_transcript, list_episodes, get_balance, list_following.
Podcast transcripts as clean Markdown with real speaker names — via the Spoken API.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Search published podcast episodes by text query, or paste an episode URL (Spotify, YouTube, etc.). Returns matching episodes with their id, title, podcast, podcast_id, and date. Use the id with get_transcript, or the podcast_id with list_episodes to get the show's whole back-catalog. Does not consume credits.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Free text (e.g. 'huberman sleep') or a pasted episode URL. |
{
"name": "search_podcasts",
"title": "Search podcasts",
"description": "Search published podcast episodes by text query, or paste an episode URL (Spotify, YouTube, etc.). Returns matching episodes with their id, title, podcast, podcast_id, and date. Use the id with get_transcript, or the podcast_id with list_episodes to get the show's whole back-catalog. Does not consume credits.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Free text (e.g. 'huberman sleep') or a pasted episode URL."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"results"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"date",
"podcast_id",
"podcast"
],
"properties": {
"id": {
"type": "string",
"description": "Episode id; pass it to get_transcript."
},
"date": {
"type": "string",
"description": "Release date, ISO 8601."
},
"title": {
"type": "string"
},
"podcast": {
"type": "string",
"description": "Show name."
},
"podcast_id": {
"type": "string",
"description": "Show id; pass it to list_episodes or follow_podcast."
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search podcasts",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Fetch a podcast episode's transcript as clean Markdown with real speaker names and timestamps. Pass an episode id from search_podcasts. Costs 1 credit on the first fetch of an episode; repeat fetches are free and errors are never charged.
| Parameter | Type | Description |
|---|---|---|
| episode_id * | string | Episode id returned by search_podcasts. |
{
"name": "get_transcript",
"title": "Get transcript",
"description": "Fetch a podcast episode's transcript as clean Markdown with real speaker names and timestamps. Pass an episode id from search_podcasts. Costs 1 credit on the first fetch of an episode; repeat fetches are free and errors are never charged.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"episode_id"
],
"properties": {
"episode_id": {
"type": "string",
"minLength": 1,
"description": "Episode id returned by search_podcasts."
}
}
},
"annotations": {
"title": "Get transcript",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List a podcast's entire back-catalog (every episode, newest first). Pass a podcast_id from a search_podcasts result. Returns each episode's id, title, and date — fetch any with get_transcript. Use this to transcribe a whole show. Does not consume credits itself; transcribing the returned episodes costs 1 credit each (repeat fetches are free), so make sure the key has enough credits before looping.
| Parameter | Type | Description |
|---|---|---|
| podcast_id * | string | Show id (the podcast_id field from a search_podcasts result). |
{
"name": "list_episodes",
"title": "List a show's episodes",
"description": "List a podcast's entire back-catalog (every episode, newest first). Pass a podcast_id from a search_podcasts result. Returns each episode's id, title, and date — fetch any with get_transcript. Use this to transcribe a whole show. Does not consume credits itself; transcribing the returned episodes costs 1 credit each (repeat fetches are free), so make sure the key has enough credits before looping.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"podcast_id"
],
"properties": {
"podcast_id": {
"type": "string",
"minLength": 1,
"description": "Show id (the podcast_id field from a search_podcasts result)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"podcast_id",
"podcast",
"count",
"episodes"
],
"properties": {
"count": {
"type": "number",
"description": "Episodes listed; fetching all of them costs up to this many credits."
},
"podcast": {
"type": "string",
"description": "Show name."
},
"episodes": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"date"
],
"properties": {
"id": {
"type": "string",
"description": "Episode id; pass it to get_transcript."
},
"date": {
"type": "string",
"description": "Release date, ISO 8601."
},
"title": {
"type": "string"
}
},
"additionalProperties": false
}
},
"podcast_id": {
"type": "string",
"description": "Show id; pass it to list_episodes or follow_podcast."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List a show's episodes",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Check the current Spoken credit balance, account email, and recent usage for the configured API key. Does not consume credits.
No parameters.
{
"name": "get_balance",
"title": "Get credit balance",
"description": "Check the current Spoken credit balance, account email, and recent usage for the configured API key. Does not consume credits.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"credits",
"usage"
],
"properties": {
"email": {
"type": "string",
"description": "Account email, when one is attached to the key."
},
"usage": {
"type": "object",
"required": [
"total",
"recent"
],
"properties": {
"total": {
"type": "number",
"description": "Episodes fetched with this key."
},
"recent": {
"type": "array",
"items": {
"type": "object",
"required": [
"episodeId",
"accessedAt"
],
"properties": {
"episodeId": {
"type": "string"
},
"accessedAt": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "The 50 most recent fetches."
}
},
"additionalProperties": false
},
"credits": {
"type": "number",
"description": "Credits remaining; one is spent per first fetch of an episode."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get credit balance",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The shows this key is kept current on. Every charged fetch makes its show a follow: the five most-fetched shows from the last 180 days are followed automatically (source 'fetch'), and up to 25 more can be declared with follow_podcast (source 'explicit'). Muted shows are listed separately. Use list_new_episodes to see what is new on them. Does not consume credits; the demo key has nothing to follow with.
No parameters.
{
"name": "list_following",
"title": "List followed shows",
"description": "The shows this key is kept current on. Every charged fetch makes its show a follow: the five most-fetched shows from the last 180 days are followed automatically (source 'fetch'), and up to 25 more can be declared with follow_podcast (source 'explicit'). Muted shows are listed separately. Use list_new_episodes to see what is new on them. Does not consume credits; the demo key has nothing to follow with.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"following",
"muted",
"limits"
],
"properties": {
"muted": {
"type": "array",
"items": {
"type": "object",
"required": [
"podcast_id",
"podcast"
],
"properties": {
"podcast": {
"type": "string",
"description": "Show name."
},
"podcast_id": {
"type": "string",
"description": "Show id; pass it to list_episodes or follow_podcast."
}
},
"additionalProperties": false
}
},
"limits": {
"type": "object",
"required": [
"explicit",
"inferred",
"inferred_window_days"
],
"properties": {
"explicit": {
"type": "number",
"description": "Most shows that can be declared with follow_podcast."
},
"inferred": {
"type": "number",
"description": "Shows followed automatically from fetches."
},
"inferred_window_days": {
"type": "number"
}
},
"additionalProperties": false
},
"following": {
"type": "array",
"items": {
"type": "object",
"required": [
"podcast_id",
"podcast",
"source",
"fetch_count"
],
"properties": {
"source": {
"enum": [
"fetch",
"explicit"
],
"type": "string",
"description": "'fetch': followed automatically from fetches. 'explicit': declared with follow_podcast."
},
"podcast": {
"type": "string",
"description": "Show name."
},
"podcast_id": {
"type": "string",
"description": "Show id; pass it to list_episodes or follow_podcast."
},
"fetch_count": {
"type": "number",
"description": "Episodes of this show fetched."
},
"last_fetched_at": {
"type": "string"
},
"newest_fetched_id": {
"type": "string",
"description": "Newest episode fetched; list_new_episodes lists what came after it."
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "List followed shows",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Declare a follow for a show, or clear a mute. Pass a podcast_id from search_podcasts. A declared follow stays until unfollow_podcast, regardless of fetch activity, and does not use one of the five automatic slots. For a show never fetched, what counts as new starts from its newest episode now. Does not consume credits.
| Parameter | Type | Description |
|---|---|---|
| podcast_id * | string | Show id (the podcast_id field from a search_podcasts result). |
{
"name": "follow_podcast",
"title": "Follow a show",
"description": "Declare a follow for a show, or clear a mute. Pass a podcast_id from search_podcasts. A declared follow stays until unfollow_podcast, regardless of fetch activity, and does not use one of the five automatic slots. For a show never fetched, what counts as new starts from its newest episode now. Does not consume credits.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"podcast_id"
],
"properties": {
"podcast_id": {
"type": "string",
"minLength": 1,
"description": "Show id (the podcast_id field from a search_podcasts result)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"podcast_id",
"podcast",
"state"
],
"properties": {
"state": {
"enum": [
"following",
"muted"
],
"type": "string"
},
"podcast": {
"type": "string",
"description": "Show name."
},
"podcast_id": {
"type": "string",
"description": "Show id; pass it to list_episodes or follow_podcast."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Follow a show",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Mute a show: it leaves the followed list and later fetches do not re-add it. follow_podcast reverses it. Pass a podcast_id from list_following. Does not consume credits.
| Parameter | Type | Description |
|---|---|---|
| podcast_id * | string | Show id, from list_following or search_podcasts. |
{
"name": "unfollow_podcast",
"title": "Stop following a show",
"description": "Mute a show: it leaves the followed list and later fetches do not re-add it. follow_podcast reverses it. Pass a podcast_id from list_following. Does not consume credits.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"podcast_id"
],
"properties": {
"podcast_id": {
"type": "string",
"minLength": 1,
"description": "Show id, from list_following or search_podcasts."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"podcast_id",
"podcast",
"state"
],
"properties": {
"state": {
"enum": [
"following",
"muted"
],
"type": "string"
},
"podcast": {
"type": "string",
"description": "Show name."
},
"podcast_id": {
"type": "string",
"description": "Show id; pass it to list_episodes or follow_podcast."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Stop following a show",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}What is new on the shows this key follows: for each show, the episodes released in the last 90 days that are newer than the newest one already fetched from it (up to 10 per show), each with a transcript_url. Episodes with no transcript are left out. Fetch any with get_transcript (1 credit each on first fetch); a fetch raises that show's floor, so the next call lists only what came after. Refreshed hourly, so a show followed moments ago may be empty until its first poll. Does not consume credits.
No parameters.
{
"name": "list_new_episodes",
"title": "List new episodes on followed shows",
"description": "What is new on the shows this key follows: for each show, the episodes released in the last 90 days that are newer than the newest one already fetched from it (up to 10 per show), each with a transcript_url. Episodes with no transcript are left out. Fetch any with get_transcript (1 credit each on first fetch); a fetch raises that show's floor, so the next call lists only what came after. Refreshed hourly, so a show followed moments ago may be empty until its first poll. Does not consume credits.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"as_of",
"count",
"shows"
],
"properties": {
"as_of": {
"type": "string",
"description": "When the list was read, ISO 8601."
},
"count": {
"type": "number",
"description": "New episodes across all followed shows."
},
"shows": {
"type": "array",
"items": {
"type": "object",
"required": [
"podcast_id",
"podcast",
"source",
"episodes"
],
"properties": {
"source": {
"enum": [
"fetch",
"explicit"
],
"type": "string",
"description": "'fetch': followed automatically from fetches. 'explicit': declared with follow_podcast."
},
"podcast": {
"type": "string",
"description": "Show name."
},
"episodes": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"date",
"transcript_url"
],
"properties": {
"id": {
"type": "string",
"description": "Episode id; pass it to get_transcript."
},
"date": {
"type": "string",
"description": "Release date, ISO 8601."
},
"title": {
"type": "string"
},
"transcript_url": {
"type": "string"
}
},
"additionalProperties": false
}
},
"podcast_id": {
"type": "string",
"description": "Show id; pass it to list_episodes or follow_podcast."
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "List new episodes on followed shows",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.