# Castos MCP by usefulapi

> Castos MCP by usefulapi is an MCP server. Read podcasts and episodes; create and update episodes; manage private subscribers in Castos. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/castos/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/castos
- **MCP Registry name:** io.usefulapi/castos
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://castos.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "castos": {
      "url": "https://castos.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/castos-mcp-by-usefulapi
