Castos MCP by usefulapi
Read podcasts and episodes; create and update episodes; manage private subscribers in Castos.
使うべきか
品質と安全性
検出事項(5)
- LOWcastos_list_private_subscribers 内
- LOWcastos_get_private_subscriber_by_email 内
- LOWcastos_create_private_subscriber 内
- LOWcastos_reactivate_private_subscriber 内
- LOWcastos_revoke_private_subscriber 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"castos": {
"url": "https://castos.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://castos.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(14)
🟢castos_list_podcasts
List the podcasts on the authenticated Castos account, with title, description, language and feed settings. Castos API: GET /podcasts.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢castos_get_podcast(podcast_id)
Get one podcast by id, with its settings and metadata. Castos API: GET /podcasts/{podcast_id}.
入力スキーマ
{
"type": "object",
"properties": {
"podcast_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric Castos id."
}
},
"required": [
"podcast_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡castos_update_podcast(podcast_id, podcast_title, podcast_description, show_type, keywords, ...)
WRITE. Change the metadata of an existing podcast. Only the fields you pass are sent. It does not change the cover image, the feed redirect or the episodes. Castos API: POST /podcasts/{podcast_id}.
入力スキーマ
{
"type": "object",
"properties": {
"podcast_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric Castos id."
},
"podcast_title": {
"description": "Podcast title.",
"type": "string"
},
"podcast_description": {
"description": "Podcast description.",
"type": "string"
},
"show_type": {
"description": "Episodic or serial show.",
"type": "string",
"enum": [
"episodic",
"serial"
]
},
"keywords": {
"description": "Comma-separated keywords.",
"type": "string"
},
"website": {
"type": "string",
"format": "uri",
"description": "A public https URL."
},
"author_name": {
"description": "Author name.",
"type": "string"
},
"podcast_owner": {
"description": "Podcast owner name.",
"type": "string"
},
"owner_email": {
"description": "Owner email address.",
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"copyright": {
"description": "Copyright line.",
"type": "string"
},
"explicit": {
"description": "'True' or 'False': explicit content.",
"type": "string"
},
"language": {
"description": "Language code, for example 'en'.",
"type": "string"
},
"itunes_category1": {
"description": "Category 1 (see castos_list_categories).",
"type": "string"
},
"itunes_category2": {
"description": "Category 2 (see castos_list_categories).",
"type": "string"
},
"itunes_category3": {
"description": "Category 3 (see castos_list_categories).",
"type": "string"
},
"itunes": {
"description": "Apple Podcasts URL.",
"type": "string"
},
"google_podcasts": {
"description": "Google Podcasts URL.",
"type": "string"
},
"feed_episodes_number": {
"description": "Number of episodes in the RSS feed.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"country_of_origin_1": {
"description": "Country of origin 1.",
"type": "string"
},
"country_of_origin_2": {
"description": "Country of origin 2.",
"type": "string"
},
"country_of_origin_3": {
"description": "Country of origin 3.",
"type": "string"
}
},
"required": [
"podcast_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢castos_list_episodes(podcast_id)
List the episodes of one podcast, with id, title, created date and publish date. Castos API: GET /podcasts/{podcast_id}/episodes.
入力スキーマ
{
"type": "object",
"properties": {
"podcast_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric Castos id."
}
},
"required": [
"podcast_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢castos_get_episode(podcast_id, episode_id)
Get one episode of a podcast by id, with its title, notes and audio details. Castos API: GET /podcasts/{podcast_id}/episodes/{episode_id}.
入力スキーマ
{
"type": "object",
"properties": {
"podcast_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric Castos id."
},
"episode_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric Castos id."
}
},
"required": [
"podcast_id",
"episode_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴castos_create_episode(podcast_id, post_title, post_content, episode_file_url, keywords, ...)
WRITE. Add a new episode to a podcast. The audio is downloaded from episode_file_url (https, up to 40 MB) and uploaded to Castos. The episode may publish to the live feed at once, so check the publish date. Castos API: POST /podcasts/{podcast_id}/episodes (multipart).
入力スキーマ
{
"type": "object",
"properties": {
"podcast_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric Castos id."
},
"post_title": {
"type": "string",
"minLength": 1,
"description": "Episode title."
},
"post_content": {
"type": "string",
"minLength": 1,
"description": "Episode show notes (HTML or text)."
},
"episode_file_url": {
"type": "string",
"format": "uri",
"description": "Public https URL of the audio file (up to 40 MB)."
},
"keywords": {
"description": "Comma-separated keywords.",
"type": "string"
},
"series_number": {
"description": "Season or series number.",
"type": "string"
},
"episode_number": {
"description": "Episode number.",
"type": "string"
},
"episode_type": {
"description": "Episode type, for example 'Full'.",
"type": "string"
},
"post_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "Publish date, yyyy-mm-dd or yyyy-mm-dd hh:mm:ss."
}
},
"required": [
"podcast_id",
"post_title",
"post_content",
"episode_file_url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡castos_update_episode(podcast_id, episode_id, post_title, post_content, updated_episode_file, ...)
WRITE. Change the text or settings of an existing episode. Only the fields you pass are sent. To replace the audio, pass updated_episode_file as a public https URL. Castos API: POST /podcasts/{podcast_id}/episodes/{episode_id}.
入力スキーマ
{
"type": "object",
"properties": {
"podcast_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric Castos id."
},
"episode_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric Castos id."
},
"post_title": {
"description": "Episode title.",
"type": "string"
},
"post_content": {
"description": "Episode show notes.",
"type": "string"
},
"updated_episode_file": {
"description": "New audio file as a public https URL.",
"type": "string",
"format": "uri"
},
"keywords": {
"description": "Comma-separated keywords.",
"type": "string"
},
"series_number": {
"description": "Season or series number.",
"type": "string"
},
"episode_number": {
"description": "Episode number.",
"type": "string"
},
"episode_type": {
"description": "Episode type.",
"type": "string"
},
"post_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}( \\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "Publish date, yyyy-mm-dd or yyyy-mm-dd hh:mm:ss."
}
},
"required": [
"podcast_id",
"episode_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢castos_list_private_subscribers(podcast_id, per_page, page)
List the private subscribers of one podcast, one page at a time. Castos API: GET /private-subscribers.
入力スキーマ
{
"type": "object",
"properties": {
"podcast_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric Castos id."
},
"per_page": {
"description": "Results per page, 1 to 250.",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"podcast_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢castos_get_private_subscriber(subscriber_id)
Get one private subscriber by subscriber id. Castos API: GET /private-subscribers/{subscriber_id}.
入力スキーマ
{
"type": "object",
"properties": {
"subscriber_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric Castos id."
}
},
"required": [
"subscriber_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢castos_get_private_subscriber_by_email(email_address)
Find a private subscriber by email. The reply lists the subscriber and its subscriptions; the subscription id is what castos_revoke_private_subscriber needs. Castos API: GET /private-subscribers/email/{email_address}.
入力スキーマ
{
"type": "object",
"properties": {
"email_address": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Subscriber email address."
}
},
"required": [
"email_address"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴castos_create_private_subscriber(podcast_id, email, name)
WRITE. Add an email address as a private subscriber of a podcast, so it can access the private feed. Castos API: POST /private-subscribers.
入力スキーマ
{
"type": "object",
"properties": {
"podcast_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric Castos id."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Subscriber email address."
},
"name": {
"description": "Subscriber name.",
"type": "string"
}
},
"required": [
"podcast_id",
"email"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡castos_reactivate_private_subscriber(subscriber_id)
WRITE. Reactivate a private subscriber by subscriber id, for example after a revoke by mistake. Castos API: POST /private-subscribers/reactivate/{subscriber_id}.
入力スキーマ
{
"type": "object",
"properties": {
"subscriber_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric Castos id."
}
},
"required": [
"subscriber_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴castos_revoke_private_subscriber(subscription_id)
WRITE. Cancel one private subscription, so the subscriber loses access to that private feed. Pass the subscription id (see castos_get_private_subscriber_by_email). Castos API: POST /private-subscribers/{subscription_id}.
入力スキーマ
{
"type": "object",
"properties": {
"subscription_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^\\d+$"
}
],
"description": "Numeric Castos id."
}
},
"required": [
"subscription_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢castos_list_categories
List the podcast categories that Castos accepts for the itunes_category fields. Castos API: GET /get-categories.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス