How to Read the Future

Official6 tools

by howtoreadthefuture

Read released episodes, transcripts, citations, clips, reading trails, and flashcards.

A server that provides access to released podcast episodes, including transcripts, citations, clips, reading trails, and flashcards.

🛠️ Key Features

Read released episodes
Access transcripts
Retrieve citations
Generate or fetch clips
Provide reading trails and flashcards

🚀 Use Cases

Researchers and readers exploring podcast content
Anyone needing transcripts and cited materials for episodes
Educational workflows with reading trails and flashcards

⚡ Developer Benefits

Clear source data: name, description, and components available
Structured access to episodes, transcripts, and assets
Compact, SEO-friendly catalog entry for discovery

⚠️ Limitations

Description based on provided fields; no additional data beyond episodes, transcripts, clips, trails, and flashcards

Captured live from the server via tools/list.

get_episode

Get one episode and its chapter metadata by slug.

Parameters1

slug

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      "maxLength": 160
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_transcript_segment

Get transcript turns overlapping an optional window of at most five minutes, with exact timestamps. Defaults to 00:00–03:00 so the first call stays within the response limit.

Parameters3

episode	string	required
start_ms	integer	optional
end_ms	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "episode": {
      "type": "string",
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      "maxLength": 160
    },
    "start_ms": {
      "type": "integer",
      "minimum": 0
    },
    "end_ms": {
      "type": "integer",
      "exclusiveMinimum": 0
    }
  },
  "required": [
    "episode"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_episode_clips

List clips for an episode, including citations, media details, and publication state.

Parameters3

slug	string	required
cursor	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      "maxLength": 160
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1024
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1,
      "default": 1
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_clip

Get one clip by ID with its URL, transcript, media, and publication details.

Parameters1

id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[a-z0-9]+(?:[-.][a-z0-9]+)*$",
      "maxLength": 160
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_reading_trail

Get an episode reading trail with citations and cursor pagination.

Parameters3

slug	string	required
cursor	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      "maxLength": 160
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1024
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 15
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_flashcards

Get reviewed, evidence-linked episode flashcards with bounded cursor pagination. No scoring or engagement coercion.

Parameters3

slug	string	required
cursor	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      "maxLength": 160
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1024
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 10
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (6)

get_episodeget_transcript_segmentlist_episode_clipsget_clipget_reading_trailget_flashcards

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://howtoreadthefuture.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "podcast": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://howtoreadthefuture.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

How to Read the Future - agentage MCP Catalog