MCP Server
Connect TubeField to your AI assistant.
Use ChatGPT or Claude in the browser? Add the URL and sign in with OAuth. Working in a dev tool? Paste a small config with your API key.
Browser assistants
ChatGPT and Claude, paste the server URL and sign in with OAuth. No keys, no files.
ChatGPT · Claude · Claude Desktop
Developer tools
Claude Code, Cursor, VS Code, Windsurf, Cline, drop in a small config with your API key, then restart.
Claude Code · Cursor · VS Code · Windsurf · Cline
Raw protocol
Any MCP-over-HTTP client, or curl for debugging, send your key as a Bearer token.
curl · custom clients
MCP server URL
https://tubefield.com/mcp
Browser assistants (ChatGPT, Claude) sign in with TubeField OAuth, nothing to paste. Developer tools send Authorization: Bearer <key>.
You're not signed in, dev-tool snippets show a YOUR_API_KEY placeholder. Sign in to auto-fill your real key and copy-paste with zero edits.
No files, no terminal. ChatGPT connects to one URL and you sign in with TubeField.
-
1
In ChatGPT, open
Settings → Apps → Advanced settingsand turn on Developer mode. On a Business/Enterprise/Edu workspace, an admin enables it first. -
2
Open
Appsand choose Create (or Add custom app / connector). -
3
Name it
tubefield, set Authentication to OAuth, and paste the server URL:Server URLhttps://tubefield.com/mcp -
4
Click Create, then Connect, a TubeField window opens; sign in (or you're recognised if already signed in) and approve. ChatGPT handles tokens for you.
-
5
Start a chat and ask: “Using tubefield, get the details for youtube.com/watch?v=dQw4w9WgXcQ.”
OAuth means there's no key to paste or leak, calls bill to your account and you can disconnect any time from ChatGPT. Custom MCP apps run in Developer mode, available on Plus, Pro, Business, Enterprise and Edu; every TubeField tool is read-only, so Plus and Pro work too. On the free plan, or if you don't see Developer mode or a Create button, check your plan and workspace policy or use a developer tool with your API key instead.
-
1
Run this once in your terminal, it registers the server for the current project. Add
-s userto enable it in every project.Terminalclaude mcp add --transport http tubefield https://tubefield.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" -
2
Verify it's registered with
claude mcp list, then ask Claude to use a tubefield tool.
Tip: keep the key out of your shell history, export TUBEFIELD_API_KEY=… first, then use "Authorization: Bearer $TUBEFIELD_API_KEY".
Any client that speaks Streamable HTTP works. To sanity-check the protocol, call the JSON-RPC endpoint directly. Per the MCP Streamable HTTP spec, clients advertise both application/json and text/event-stream in Accept; TubeField replies with a single JSON response. Header clients authenticate with Authorization: Bearer YOUR_API_KEY.
curl -sS https://tubefield.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
curl -sS https://tubefield.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"video_detail","arguments":{"video_id":"dQw4w9WgXcQ"}}}'
Connector details (optional)
When you create a connector, ChatGPT may ask for a name, description and icon. They're optional, copy our ready-made set, or skip them. Claude only asks for a name.
Name
TubeField
Description
YouTube search, video details, transcripts, comments, channels and playlists.
Recommended, add the Research Skill (optional)
MCP gives your agent the tools. The free Research Skill is the playbook for using them well, so it samples properly, reads transcripts and separates claims from reactions. One plain SKILL.md file.
Tool reference
12 tools, one per REST endpoint.
| Tool | What it does | Price |
|---|---|---|
| video_detail | Title, channel, publish date, duration and view/like/comment counts. | $0.003 |
| video_comments | Top comments on a video as plain text. | $0.003 |
| video_transcript | Timestamped transcript of a video. | $0.003 |
| channel_detail | Channel profile with subscriber, view and video counts. Takes a channel id or @handle. | $0.003 |
| channel_videos | A channel's latest uploads, by id or @handle. | $0.003 |
| channel_playlists | A channel's public playlists, by id or @handle. | $0.003 |
| channel_lookup | Resolve a channel @handle ⇄ id (both directions). | Free |
| playlist_detail | Playlist title, owning channel and item count. | $0.003 |
| playlist_videos | Videos in a playlist, in order. | $0.003 |
| search_videos | Search YouTube for videos matching a keyword. | $0.01 |
| search_result | Search plus full detail and transcript for each result, in one call. | $0.016–$0.07 |
| account_balance | Your remaining prepaid balance, as credits and a dollar amount. No arguments. | Free |
These mirror the REST API 1:1, anything you can do over HTTP, you can do as a tool. Browse the full API.
Billing is shared with the REST API
MCP calls draw from the same prepaid balance, no subscription, no monthly credits. You're charged per call: $0.003 for standard tools, $0.01 for search, and $0.016–$0.07 for search_result (you only pay for results returned). channel_lookup and account_balance are free. When your balance hits zero, calls return a 402 until you top up.
The questions teams ask before they connect
Setup & Connection
Auth & Billing
Give your product and agents YouTube data.
Start with a free key and about 150 free requests, on REST, MCP, or both.