TorBox has an MCP server, which lets you connect your account to AI apps like Claude, Codex, Grok, Antigravity and OpenCode. Once it's connected, your AI can add downloads, manage your list and check your account when you ask it to.
What you'll need
A paid TorBox plan
An AI app that lets you add MCP servers
You sign in through your browser, so you don't need your API key
Add TorBox to your AI
Find your AI below and follow the steps. Whenever it asks for a server address, use this one:
https://api.torbox.app/mcp
Claude
Claude
Claude app (web and desktop)
Go to Customize, then Connectors.
Click Add, then Add custom connector.
Call it TorBox, paste in the address above and click Continue.
Leave the sign in settings as they are and click Add.
Click Connect to sign in.
Need more detail? See adding a custom connector in Claude.
Claude Code
Run this in your terminal:
claude mcp add --transport http torbox https://api.torbox.app/mcp
Then open Claude Code, type /mcp, pick torbox and hit Authenticate.
Need more detail? See connecting MCP servers in Claude Code.
Codex
Codex
Codex app
Go to Settings, then MCP servers.
Click Add server.
Call it TorBox, pick Streamable HTTP and paste in the address above.
Save it, then click Restart.
Click Authenticate next to TorBox.
Codex CLI
Run these in your terminal:
codex mcp add torbox --url https://api.torbox.app/mcp
codex mcp login torbox
Need more detail? See adding MCP servers in Codex.
Grok
Grok
Grok on the web
Head to grok.com/connectors.
Click New Connector, then Custom.
Paste in the address above and sign in when it asks.
Grok Build
Run this in your terminal:
grok mcp add --transport http torbox https://api.torbox.app/mcp
Grok will ask you to sign in the first time it uses TorBox. You can also type /mcps, pick torbox and press i.
Need more detail? See adding MCP servers in Grok Build.
Antigravity
Antigravity
First, open your mcp_config.json file:
Antigravity IDE: click ... at the top of the agent side panel, then MCP Servers, Manage MCP Servers and View raw config.
Antigravity App: go to Customizations, then Installed, and click Copy Config File Path in the MCP Servers section.
Then add TorBox to it like this and save the file:
{
"mcpServers": {
"torbox": {
"serverUrl": "https://api.torbox.app/mcp"
}
}
}
To sign in:
Click Authenticate next to TorBox in your MCP Servers list.
Finish signing in to TorBox in your browser, then copy the authorization code it gives you.
Paste the code into the Enter authorization code box and click Submit.
Need more detail? See MCP in Antigravity.
OpenCode
OpenCode
Add TorBox to your opencode.json file:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"torbox": {
"type": "remote",
"url": "https://api.torbox.app/mcp"
}
}
}
}
Then run this to sign in:
opencode mcp auth torbox
Or type /mcps inside OpenCode and pick TorBox from there.
Need more detail? See adding MCP servers in OpenCode.
Using something else? Most AI apps let you add a remote MCP server. Add it with the address above, then sign in the same way. Your AI can usually help you set it up if you ask it.
Sign in to TorBox
The first time your AI connects, it'll open a TorBox page in your browser. We've used Claude in the screenshots, but it works the same way for all of them.
You'll see what your AI will be able to do on your account. Take note of the confirmation code on the right, then click Continue on TorBox.
Check the device code matches the one from step 1, and that you're logged in to the right TorBox account.
Click Continue and you're done.
The codes are blurred in our screenshots, but yours will show normally.
Your AI is now connected. A quick way to test it is to ask it to show your current downloads.
What your AI can do
Once it's connected, your AI can:
Add, manage and delete your downloads
Get download links for your files
See your account and change your settings
It can't change your password or delete your account.
Important: anything your AI does on your account is on you, so keep its usage within fair use. If your AI does something abusive, we treat it the same as if you did it.
Teach your AI about TorBox
We also have TorBox skills, which are instructions your AI can load so it knows how TorBox works. They're handy if you're building your own scripts or tools, or setting up a media player. You can find them on our GitHub.
torbox-api teaches your AI how to use the TorBox API, like adding downloads, checking the cache, getting download links and fixing errors.
torbox-webdav teaches your AI how to use TorBox WebDAV, like connecting a player, finding your files and fixing login problems.
Claude Code
Claude Code
Run this inside Claude Code:
/plugin install torbox --marketplace TorBox-App/ai-skills
On older versions of Claude Code, run these instead:
/plugin marketplace add TorBox-App/ai-skills
/plugin install torbox@torbox-skills
Then run /reload-plugins or start a new session.
Codex, Gemini CLI, Cursor and GitHub Copilot
Codex, Gemini CLI, Cursor and GitHub Copilot
Run these in your terminal to copy the skills into the folder your AI loads them from:
git clone https://github.com/TorBox-App/ai-skills.git
mkdir -p ~/.agents/skills
cp -R ai-skills/skills/torbox-api ~/.agents/skills/
cp -R ai-skills/skills/torbox-webdav ~/.agents/skills/
Any other AI
Any other AI
If your AI supports skills, copy the skill folders from our GitHub into its skills folder. If it doesn't, you can attach the skill's SKILL.md file to your chat or paste its contents in.
Once it's added, just ask for what you want and your AI will use the skill on its own.
Important: if you use the skills without the MCP server, your AI will need your API key from your TorBox settings. Your API key gives full access to your account, so only give it to an AI you trust.
Disconnect your AI
Remove the TorBox MCP server (or connector) from your AI app, the same place you added it.


