Remote MCP

Give your agent
YouTube transcripts.

Threadmap works with Codex and other agents that support remote Streamable HTTP MCP servers. Connect through OAuth without copying an API key.

Codex ยท OAuth setup

Add the URL. Sign in.

No API key to copy. Codex opens Threadmap in your browser, then securely stores and refreshes its own OAuth credential.

  1. 01

    Add the Threadmap server

    You only need the public MCP address.

    codex mcp add threadmap --url https://threadmap.online/mcp
  2. 02

    Authorize in your browser

    codex mcp login threadmap

    Sign in to Threadmap and select Allow access. Open /mcp in Codex to confirm the connection.

Prefer config.toml?

Add this block to ~/.codex/config.toml, restart Codex, and choose Authenticate in the MCP server settings.

[mcp_servers.threadmap]
url = "https://threadmap.online/mcp"
enabled_tools = ["get_youtube_transcript", "get_transcript_usage"]
tool_timeout_sec = 300
default_tools_approval_mode = "writes"
Use an API key instead

Bearer API keys remain supported for servers and older MCP clients. See the manual connection reference.

Any compatible agent

Use three connection fields.

In a compatible client's MCP settings, add a remote server. OAuth discovery and sign-in happen automatically.

TransportStreamable HTTP
Server URLhttps://threadmap.online/mcp
AuthorizationOAuth 2.1 + PKCE

Select Authenticate or Connect after saving the URL.

What your agent gets

Two focused tools.

Transcriptget_youtube_transcript

Fetch a timestamped transcript from a public YouTube URL or video ID. Existing captions and cached transcripts are free; only fresh audio transcription uses credits.

Usageget_transcript_usage

Check the current credit balance without consuming credits.

Ready

Connect Threadmap in a minute.

Add the URL, sign in, and ask your agent for a YouTube transcript.

View Codex setup