# Spoken (remote · spoken.md)

Podcast transcripts as clean Markdown with real speaker names — via the Spoken API.

- Trust score: 95/100 (high trust)
- Change this week: +2
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- remote · `spoken.md`: 95/100 (this document), [markdown](https://verifymcp.io/servers/spokenmd-spoken/spoken.md), [page](https://verifymcp.io/servers/spokenmd-spoken/spoken)
- npm · `spoken-mcp`: 86/100, [markdown](https://verifymcp.io/servers/spokenmd-spoken/spoken-mcp.md), [page](https://verifymcp.io/servers/spokenmd-spoken/spoken-mcp)

## Channel facts

- Endpoint: `https://spoken.md/mcp`
- Transports: `streamable-http`
- Auth: `required`
- Version: `0.4.3`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Endpoint Security**: 95/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
  - The authorisation server supports Client ID Metadata Documents, the current MCP client-registration mechanism.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 83/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 718 tokens (~89/item across 8 items; 8 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 100/100
  - No destabilizing schema changes in the last 30 days.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (88% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 8 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 8 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the Spoken MCP server?

Spoken is a hosted endpoint at https://spoken.md/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http spokenmd-spoken 'https://spoken.md/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "spokenmd-spoken": {
      "url": "https://spoken.md/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "spokenmd-spoken": {
      "type": "http",
      "url": "https://spoken.md/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.spokenmd-spoken]
url = "https://spoken.md/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "spokenmd-spoken": {
      "type": "remote",
      "url": "https://spoken.md/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add spokenmd-spoken --url 'https://spoken.md/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  spokenmd-spoken:
    url: "https://spoken.md/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "spokenmd-spoken": {
      "Transport": "http",
      "Url": "https://spoken.md/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add spokenmd-spoken -t streamable-http -u 'https://spoken.md/mcp'
```

### Other

```json
{
  "mcpServers": {
    "spokenmd-spoken": {
      "type": "http",
      "url": "https://spoken.md/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-03 (score 95, 0)

- [security] Stability: 0.97 → pass

### 2026-11-02 (score 95, +1)

No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-31 (score 94, +1)

No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-29 (score 93, +1)

No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-27 (score 92, +1)

No change was recorded against any check on this day. Stability & Change Management went from 73 to 77. That category is still filling its 30-day observation window: 22 days of observed history at the previous scan, 23 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-25 (score 91, +1)

No change was recorded against any check on this day. Stability & Change Management went from 67 to 70. That category is still filling its 30-day observation window: 20 days of observed history at the previous scan, 21 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-23 (score 90, +1)

No change was recorded against any check on this day. Stability & Change Management went from 60 to 63. That category is still filling its 30-day observation window: 18 days of observed history at the previous scan, 19 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-21 (score 89, +1)

No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.

## MCP tools (8)

### `search_podcasts` (~101 tokens)

Search podcasts

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.

Input parameters:

- `query` (string, required): Free text (e.g. 'huberman sleep') or a pasted episode URL.

Output parameters:

- `results` (array)

### `get_transcript` (~74 tokens)

Get transcript

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.

Input parameters:

- `episode_id` (string, required): Episode id returned by search_podcasts.

### `list_episodes` (~119 tokens)

List a show's episodes

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.

Input parameters:

- `podcast_id` (string, required): Show id (the podcast_id field from a search_podcasts result).

Output parameters:

- `count` (number): Episodes listed; fetching all of them costs up to this many credits.
- `episodes` (array)
- `podcast` (string): Show name.
- `podcast_id` (string): Show id; pass it to list_episodes or follow_podcast.

### `get_balance` (~32 tokens)

Get credit balance

Check the current Spoken credit balance, account email, and recent usage for the configured API key. Does not consume credits.

Output parameters:

- `credits` (number): Credits remaining; one is spent per first fetch of an episode.
- `email` (string): Account email, when one is attached to the key.
- `usage` (object)

### `list_following` (~99 tokens)

List followed shows

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.

Output parameters:

- `following` (array)
- `limits` (object)
- `muted` (array)

### `follow_podcast` (~101 tokens)

Follow a show

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.

Input parameters:

- `podcast_id` (string, required): Show id (the podcast_id field from a search_podcasts result).

Output parameters:

- `podcast` (string): Show name.
- `podcast_id` (string): Show id; pass it to list_episodes or follow_podcast.
- `state` (string)

### `unfollow_podcast` (~71 tokens)

Stop following a show

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.

Input parameters:

- `podcast_id` (string, required): Show id, from list_following or search_podcasts.

Output parameters:

- `podcast` (string): Show name.
- `podcast_id` (string): Show id; pass it to list_episodes or follow_podcast.
- `state` (string)

### `list_new_episodes` (~121 tokens)

List new episodes on followed shows

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.

Output parameters:

- `as_of` (string): When the list was read, ISO 8601.
- `count` (number): New episodes across all followed shows.
- `shows` (array)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/spokenmd-spoken/spoken#diagnostics

## Score history

- 2026-11-05: 95
- 2026-11-04: 95
- 2026-11-03: 95
- 2026-11-02: 95
- 2026-11-01: 94
- 2026-10-31: 94
- 2026-10-30: 93
- 2026-10-29: 93
- 2026-10-28: 92
- 2026-10-27: 92
- 2026-10-26: 91
- 2026-10-25: 91
- 2026-10-24: 90
- 2026-10-23: 90
- 2026-10-22: 89
- 2026-10-21: 89
- 2026-10-20: 88
- 2026-10-19: 88
- 2026-10-18: 88
- 2026-10-17: 87
- 2026-10-16: 87
- 2026-10-15: 86
- 2026-10-14: 86
- 2026-10-13: 85
- 2026-10-12: 85
- 2026-10-10: 84
- 2026-10-06: 80
- 2026-10-04: 79

## Common questions

### What is the Spoken MCP server?

Spoken is an MCP server listed in the public MCP registry as io.github.spokenmd/spoken. Podcast transcripts as clean Markdown with real speaker names, via the Spoken API. This page covers its hosted endpoint (https://spoken.md/mcp).

### Is the Spoken MCP server safe to use?

Spoken scores 95 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Spoken MCP server expose?

Spoken exposes 8 tools: search_podcasts, get_transcript, list_episodes, get_balance, list_following, and 3 more. Their descriptions and schemas cost roughly 718 tokens of context every time the server is loaded.

### Does the Spoken MCP server require authentication?

Yes. Spoken asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

### Is the Spoken MCP server still maintained?

Spoken is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the Spoken MCP server?

VerifyMCP ran 13 checks on Spoken, covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://spoken.md/mcp
- Repository: https://github.com/spokenmd/spoken
- Website: https://spoken.md/
- Changelog RSS feed: https://verifymcp.io/servers/spokenmd-spoken/spoken.xml
- Changelog JSON feed: https://verifymcp.io/servers/spokenmd-spoken/spoken/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/spokenmd-spoken/spoken.json
- HTML version of this page: https://verifymcp.io/servers/spokenmd-spoken/spoken
