Threadmap

Remote MCP

Give your agent
YouTube transcripts.

Threadmap works with Codex and other agents that support remote Streamable HTTP MCP servers. Your API key stays in your MCP client.

1. Get an API key 2. Connect your agent

Codex ยท fastest setup

Copy two commands.

Run these in the same terminal where you start Codex. The setting is shared by the Codex app, CLI, and IDE extension on the same computer.

  1. 01

    Add your key for this terminal

    Replace the placeholder with the key from your Threadmap dashboard.

    export THREADMAP_API_KEY="tm_live_YOUR_KEY"
  2. 02

    Add Threadmap to Codex

    codex mcp add threadmap --url https://threadmap.online/mcp --bearer-token-env-var THREADMAP_API_KEY

    Restart Codex after adding the server. Open /mcp to confirm that Threadmap is connected.

Prefer config.toml?

Add this block to ~/.codex/config.toml. Codex must be able to read THREADMAP_API_KEY from its environment.

[mcp_servers.threadmap]
url = "https://threadmap.online/mcp"
bearer_token_env_var = "THREADMAP_API_KEY"
enabled_tools = ["get_youtube_transcript", "get_transcript_usage"]
tool_timeout_sec = 300
default_tools_approval_mode = "writes"

Any compatible agent

Use three connection fields.

In your agent's MCP settings, add a remote server and enter the values below. Labels differ between clients.

TransportStreamable HTTP
Server URLhttps://threadmap.online/mcp
AuthorizationBearer tm_live_YOUR_KEY

Replace the placeholder with your API key.

What your agent gets

Two focused tools.

Transcriptget_youtube_transcript

Fetch a timestamped transcript from a public YouTube URL or video ID. Successful calls use minute credits.

Usageget_transcript_usage

Check the current minute balance without consuming credits.

Ready

Connect Threadmap in a minute.

Create your key, copy the setup, and ask your agent for a YouTube transcript.

Get an API key