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.
-
01
Add the Threadmap server
You only need the public MCP address.
codex mcp add threadmap --url https://threadmap.online/mcp -
02
Authorize in your browser
codex mcp login threadmapSign in to Threadmap and select Allow access. Open
/mcpin 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.
Select Authenticate or Connect after saving the URL.
What your agent gets
Two focused tools.
get_youtube_transcriptFetch a timestamped transcript from a public YouTube URL or video ID. Existing captions and cached transcripts are free; only fresh audio transcription uses credits.
get_transcript_usageCheck 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.