Skip to content
MCP server

Castos MCP by usefulapi

Read podcasts and episodes; create and update episodes; manage private subscribers in…

Install
Runs
Remotely
Version
1.4.0
Listing updated
4 days ago

About Castos MCP by usefulapi

Castos MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read podcasts and episodes; create and update episodes; manage private subscribers in Castos.

Install

Run in a terminal

claude mcp add --transport http castos https://castos.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://castos.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "castos": {
      "url": "https://castos.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "castos": {
      "type": "http",
      "url": "https://castos.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "castos": {
      "serverUrl": "https://castos.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "castos": {
      "type": "http",
      "url": "https://castos.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (14)

Read directly from the server.

castos_list_podcasts
List the podcasts on the authenticated Castos account, with title, description, language and feed settings. Castos API: GET /podcasts.
castos_get_podcast
Get one podcast by id, with its settings and metadata. Castos API: GET /podcasts/{podcast_id}.
castos_update_podcast
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}.
castos_list_episodes
List the episodes of one podcast, with id, title, created date and publish date. Castos API: GET /podcasts/{podcast_id}/episodes.
castos_get_episode
Get one episode of a podcast by id, with its title, notes and audio details. Castos API: GET /podcasts/{podcast_id}/episodes/{episode_id}.
castos_create_episode
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).
castos_update_episode
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}.
castos_list_private_subscribers
List the private subscribers of one podcast, one page at a time. Castos API: GET /private-subscribers.
castos_get_private_subscriber
Get one private subscriber by subscriber id. Castos API: GET /private-subscribers/{subscriber_id}.
castos_get_private_subscriber_by_email
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}.
castos_create_private_subscriber
WRITE. Add an email address as a private subscriber of a podcast, so it can access the private feed. Castos API: POST /private-subscribers.
castos_reactivate_private_subscriber
WRITE. Reactivate a private subscriber by subscriber id, for example after a revoke by mistake. Castos API: POST /private-subscribers/reactivate/{subscriber_id}.
castos_revoke_private_subscriber
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}.
castos_list_categories
List the podcast categories that Castos accepts for the itunes_category fields. Castos API: GET /get-categories.

Castos MCP by usefulapi FAQ

How do I add Castos MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http castos https://castos.usefulapi.io/mcp