Read shows, episodes, and audio, and speak a script, with a PostPod API key.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer PostPod API key created on the API page. Send Authorization: Bearer pp_live_…
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Debit prepaid credits and queue audio for a script. The price matches estimate_script_audio. A low balance returns 402. Pass idempotency_key to retry without a second debit. Set confirm_another when you mean to pay for another job. A 409 script_audio_active includes job_id and job_url. The message says you have already paid only when that job was charged. Otherwise it says you already have audio being made. A queued job with no progress for more than 30 minutes, or a render with no progress or heartbeat for 2 hours, is failed before that 409. The audio has no intro or outro. Narrators are Nora, Leo, Kristine, Ken, and Marko.
Narrator display name or lowercase id: Nora, Leo, Kristine, Ken, or Marko.
The words to speak.
auto or a language code. Defaults to auto.
Set true to pay for another job while one is still running, or to submit the same script again within 15 minutes.
Optional retry key, 8 to 80 letters, numbers, underscores, or hyphens. The same key does not debit twice.
Language code for the spoken audio. Defaults to English (en).
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http postpod https://postpodai.com/api/mcp \ --header 'Authorization: Bearer YOUR_TOKEN'
Headers
Authorization (required): Bearer PostPod API key created on the API page. Send Authorization: Bearer pp_live_…Debit prepaid credits and queue audio for a script. The price matches estimate_script_audio. A low balance returns 402. Pass idempotency_key to retry without a second debit. Set confirm_another when you mean to pay for another job. A 409 script_audio_active includes job_id and job_url. The message says you have already paid only when that job was charged. Otherwise it says you already have audio being made. A queued job with no progress for more than 30 minutes, or a render with no progress or heartbeat for 2 hours, is failed before that 409. The audio has no intro or outro. Narrators are Nora, Leo, Kristine, Ken, and Marko.
| Argument | Type | Description |
|---|---|---|
| voice* | string | Narrator display name or lowercase id: Nora, Leo, Kristine, Ken, or Marko. |
| script* | string | The words to speak. |
| input_language | string | auto or a language code. Defaults to auto. |
| confirm_another | boolean | Set true to pay for another job while one is still running, or to submit the same script again within 15 minutes. |
| idempotency_key | string | Optional retry key, 8 to 80 letters, numbers, underscores, or hyphens. The same key does not debit twice. |
| output_language | string | Language code for the spoken audio. Defaults to English (en). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"script",
"voice"
],
"properties": {
"voice": {
"type": "string",
"minLength": 1,
"description": "Narrator display name or lowercase id: Nora, Leo, Kristine, Ken, or Marko."
},
"script": {
"type": "string",
"minLength": 1,
"description": "The words to speak."
},
"input_language": {
"type": "string",
"description": "auto or a language code. Defaults to auto."
},
"confirm_another": {
"type": "boolean",
"description": "Set true to pay for another job while one is still running, or to submit the same script again within 15 minutes."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,80}$",
"description": "Optional retry key, 8 to 80 letters, numbers, underscores, or hyphens. The same key does not debit twice."
},
"output_language": {
"type": "string",
"description": "Language code for the spoken audio. Defaults to English (en)."
}
},
"additionalProperties": false
}Create this account's daily podcast show from X accounts and topics. Fails if a show already exists. Language defaults to English. Free accounts stay English only and can follow 3 accounts. Pro can follow 25. Nora is the free voice. Leo, Kristine, Ken, and Marko need Pro for the daily show. This does not change the subscription.
| Argument | Type | Description |
|---|---|---|
| name | string | Show name. A blank name uses the default. |
| voice* | string | Narrator display name or lowercase id: Nora, Leo, Kristine, Ken, or Marko. |
| topics | array | Suggested topics: news, sports, ai, finance, or crypto. Listeners pick X accounts and topics. PostPod picks the posts. |
| handles* | array | Public X accounts to follow, without the @ sign. topic_apply replace fills this list from topics, up to the Free cap of 3 or the Pro cap of 25. |
| language | string | Language code. Defaults to English (en). Free accounts stay English only. Pro can use any supported language. |
| timezone* | string | IANA timezone, for example America/New_York. |
| topic_apply | string | replace or add fills handles from topics, using the Free cap of 3 accounts or the Pro cap of 25. Omit it to store topics without changing handles. |
| delivery_hhmm* | string | Delivery time on the hour or half-hour, 24-hour HH:MM. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"handles",
"voice",
"timezone",
"delivery_hhmm"
],
"properties": {
"name": {
"type": "string",
"description": "Show name. A blank name uses the default."
},
"voice": {
"type": "string",
"minLength": 1,
"description": "Narrator display name or lowercase id: Nora, Leo, Kristine, Ken, or Marko."
},
"topics": {
"type": "array",
"items": {
"enum": [
"news",
"sports",
"ai",
"finance",
"crypto"
],
"type": "string"
},
"description": "Suggested topics: news, sports, ai, finance, or crypto. Listeners pick X accounts and topics. PostPod picks the posts."
},
"handles": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Public X accounts to follow, without the @ sign. topic_apply replace fills this list from topics, up to the Free cap of 3 or the Pro cap of 25."
},
"language": {
"type": "string",
"description": "Language code. Defaults to English (en). Free accounts stay English only. Pro can use any supported language."
},
"timezone": {
"type": "string",
"minLength": 1,
"description": "IANA timezone, for example America/New_York."
},
"topic_apply": {
"enum": [
"replace",
"add"
],
"type": "string",
"description": "replace or add fills handles from topics, using the Free cap of 3 accounts or the Pro cap of 25. Omit it to store topics without changing handles."
},
"delivery_hhmm": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):(?:00|30)$",
"description": "Delivery time on the hour or half-hour, 24-hour HH:MM."
}
},
"additionalProperties": false
}Delete one daily episode the same way the website Library does. The row stays as a tombstone, the script is cleared, and the audio file is removed. That delivery day is not generated again, except for the website's admin reopen of the same row. An episode that is not this account's returns the same not-found result as a missing id. Deleting it again is success. This does not debit prepaid credits.
| Argument | Type | Description |
|---|---|---|
| id* | string | Episode id. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
"description": "Episode id."
}
},
"additionalProperties": false
}Price a script without creating a job or spending credits. Voices are Nora, Leo, Kristine, Ken, and Marko. Output language defaults to English. The audio has no intro or outro.
| Argument | Type | Description |
|---|---|---|
| voice* | string | Narrator display name or lowercase id: Nora, Leo, Kristine, Ken, or Marko. |
| script* | string | The words to speak. |
| input_language | string | auto or a language code. Defaults to auto. |
| output_language | string | Language code for the spoken audio. Defaults to English (en). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"script",
"voice"
],
"properties": {
"voice": {
"type": "string",
"minLength": 1,
"description": "Narrator display name or lowercase id: Nora, Leo, Kristine, Ken, or Marko."
},
"script": {
"type": "string",
"minLength": 1,
"description": "The words to speak."
},
"input_language": {
"type": "string",
"description": "auto or a language code. Defaults to auto."
},
"output_language": {
"type": "string",
"description": "Language code for the spoken audio. Defaults to English (en)."
}
},
"additionalProperties": false
}Start today's episode for this show. Uses the same Free and Pro rules as the website: one episode per delivery day, the same deleted-day tombstone, and the same pipeline. Free is one episode a day. This does not debit prepaid credits. Poll get_episode with the returned id. discard_script drops the saved draft and writes a new script.
| Argument | Type | Description |
|---|---|---|
| id* | string | Show id. |
| discard_script | boolean | Set true to drop the saved draft and write a new script. Omit it to keep a saved draft. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
"description": "Show id."
},
"discard_script": {
"type": "boolean",
"description": "Set true to drop the saved draft and write a new script. Omit it to keep a saved draft."
}
},
"additionalProperties": false
}Read the account that owns this API key, including plan, limits, today's usage, and the prepaid credit balance in USD.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}Get one daily episode, including its script when one was saved.
| Argument | Type | Description |
|---|---|---|
| id* | string | Episode id. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
"description": "Episode id."
}
},
"additionalProperties": false
}Get a temporary MP3 URL for a ready daily episode. The URL expires in six hours. Audio past the retention window returns 410.
| Argument | Type | Description |
|---|---|---|
| id* | string | Episode id. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
"description": "Episode id."
}
},
"additionalProperties": false
}Get a temporary MP3 URL for a ready Script to audio job.
| Argument | Type | Description |
|---|---|---|
| id* | string | Script job id. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
"description": "Script job id."
}
},
"additionalProperties": false
}Get one Script to audio job, including progress and estimated seconds remaining.
| Argument | Type | Description |
|---|---|---|
| id* | string | Script job id. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
"description": "Script job id."
}
},
"additionalProperties": false
}Get one daily podcast show by id.
| Argument | Type | Description |
|---|---|---|
| id* | string | Show id. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
"description": "Show id."
}
},
"additionalProperties": false
}List recent daily episodes for this account, newest delivery date first. This does not generate an episode. Use generate_episode to start today's episode.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}List Script to audio jobs for this account. Queued and generating jobs are included, with in_progress true, so you can see the job that blocks a new create.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}List this account's daily podcast show. An account has at most one show.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}Replace the daily show's name, X accounts, topics, language, voice, timezone, and delivery time. The same plan limits as create apply. topic_apply fills accounts from topics up to the Free or Pro cap. This does not change the subscription.
| Argument | Type | Description |
|---|---|---|
| id* | string | Show id. |
| name | string | Show name. A blank name uses the default. |
| voice* | string | Narrator display name or lowercase id: Nora, Leo, Kristine, Ken, or Marko. |
| topics | array | Suggested topics: news, sports, ai, finance, or crypto. Listeners pick X accounts and topics. PostPod picks the posts. |
| handles* | array | Public X accounts to follow, without the @ sign. topic_apply replace fills this list from topics, up to the Free cap of 3 or the Pro cap of 25. |
| language | string | Language code. Defaults to English (en). Free accounts stay English only. Pro can use any supported language. |
| timezone* | string | IANA timezone, for example America/New_York. |
| topic_apply | string | replace or add fills handles from topics, using the Free cap of 3 accounts or the Pro cap of 25. Omit it to store topics without changing handles. |
| delivery_hhmm* | string | Delivery time on the hour or half-hour, 24-hour HH:MM. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"handles",
"voice",
"timezone",
"delivery_hhmm"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
"description": "Show id."
},
"name": {
"type": "string",
"description": "Show name. A blank name uses the default."
},
"voice": {
"type": "string",
"minLength": 1,
"description": "Narrator display name or lowercase id: Nora, Leo, Kristine, Ken, or Marko."
},
"topics": {
"type": "array",
"items": {
"enum": [
"news",
"sports",
"ai",
"finance",
"crypto"
],
"type": "string"
},
"description": "Suggested topics: news, sports, ai, finance, or crypto. Listeners pick X accounts and topics. PostPod picks the posts."
},
"handles": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Public X accounts to follow, without the @ sign. topic_apply replace fills this list from topics, up to the Free cap of 3 or the Pro cap of 25."
},
"language": {
"type": "string",
"description": "Language code. Defaults to English (en). Free accounts stay English only. Pro can use any supported language."
},
"timezone": {
"type": "string",
"minLength": 1,
"description": "IANA timezone, for example America/New_York."
},
"topic_apply": {
"enum": [
"replace",
"add"
],
"type": "string",
"description": "replace or add fills handles from topics, using the Free cap of 3 accounts or the Pro cap of 25. Omit it to store topics without changing handles."
},
"delivery_hhmm": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):(?:00|30)$",
"description": "Delivery time on the hour or half-hour, 24-hour HH:MM."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 19, 2026.