FetchPan for AI agents.

Let your agent download from file hosts and Chinese cloud drives. One token, the same free files and traffic as your FetchPan account.

What is the FetchPan MCP server?

FetchPan is a download service for file hosts (Rapidgator, Katfile, Nitroflare, Turbobit and others) and Chinese cloud drives (Baidu Netdisk, Quark, PikPak and others). Its MCP server lets an AI agent use it: the agent sends a link and gets back a direct download URL.

It works with any MCP client that supports remote servers (Streamable HTTP) and a Bearer token. Below are step-by-step guides for Codex, WorkBuddy and Claude Code. The same token also works on the REST API.

https://fetchpan.com/mcp

1. Create an API token

A token lets a program act as your account. Treat it like a password: anyone who has it can use your free files and your traffic balance.

Loading…

2. Connect your agent

Pick your tool. Replace YOUR_TOKEN with the token from step 1 (it fills in by itself right after you create one).

Add this to ~/.codex/config.toml

# 1) in ~/.zshrc or ~/.bashrc, then restart the terminal:
export FETCHPAN_TOKEN="YOUR_TOKEN"

# 2) in ~/.codex/config.toml:
[mcp_servers.fetchpan]
url = "https://fetchpan.com/mcp"
bearer_token_env_var = "FETCHPAN_TOKEN"

Then ask your agent: “List the FetchPan tools.” If it names download, check_link and get_account, you are connected.

Install guides

Create a token first (step 1). Replace YOUR_TOKEN with it. Each guide takes about two minutes.

Codex (OpenAI Codex CLI, IDE extension and app)

Create a token above and copy it.
Add the token to your shell profile (~/.zshrc or ~/.bashrc) as the variable FETCHPAN_TOKEN, then restart the terminal.
Open ~/.codex/config.toml (create it if it does not exist) and add the [mcp_servers.fetchpan] block below. To use it in one project only, put the block in .codex/config.toml inside a trusted project.
Start Codex and type /mcp. fetchpan should be listed. In a plain terminal, codex mcp list shows it too.
Ask: “Use FetchPan to check this link: …”.

Add this to ~/.codex/config.toml

# 1) in ~/.zshrc or ~/.bashrc, then restart the terminal:
export FETCHPAN_TOKEN="YOUR_TOKEN"

# 2) in ~/.codex/config.toml:
[mcp_servers.fetchpan]
url = "https://fetchpan.com/mcp"
bearer_token_env_var = "FETCHPAN_TOKEN"

If you open Codex from an app icon instead of a terminal, it may not see your shell variables. Then replace the bearer_token_env_var line with: http_headers = { Authorization = "Bearer YOUR_TOKEN" } (the token is then stored in the file, so keep the file private).

WorkBuddy

Create a token above and copy it.
In WorkBuddy open Connectors, then Custom connector, then click Configure MCP (top right). This opens the file ~/.workbuddy/mcp.json. Menu names can differ a little between versions.
Add the fetchpan entry below inside mcpServers. Keep any entries that are already there. Click Save.
Open My MCP and switch fetchpan on. If WorkBuddy asks you to trust the server, confirm.
Start a task and ask: “List the FetchPan tools.” You should see download, check_link and get_account.

Add this to ~/.workbuddy/mcp.json

{
  "mcpServers": {
    "fetchpan": {
      "type": "http",
      "url": "https://fetchpan.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Claude Code

Create a token above and copy it.
Run the command below in your terminal.
Run claude mcp list, or type /mcp inside Claude Code. fetchpan should show as connected.
Ask: “Use FetchPan to download this link: …”.

claude mcp add --transport http fetchpan https://fetchpan.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

What the agent can do

Nine tools. Your agent normally needs only download.

Tool	What it does	Uses
download	Give it a link; it waits for the file and returns a download URL. If the file is not ready in time, it returns a job id to continue with.	1 free file, or traffic (fast)
check_link	Is this site supported and working right now?	nothing
list_supported_sites	All supported sites with live status.	nothing
start_download	Start a job without waiting. Returns a job id.	nothing
get_job	Job status, and what a free or fast download would cost.	nothing
get_download_link	The URL for a finished job (free or fast).	1 free file, or traffic (fast)
get_account	Your email, traffic balance, free files per day and recent downloads.	nothing
list_packages	Traffic packs you can buy.	nothing
create_payment_link	A payment page for a pack, to give to you. Only a person can pay it.	nothing

How a download works

The agent calls download with the link you gave it.
FetchPan opens the link and returns a URL on fetchpan.com. It works for 12 hours and supports resume (HTTP Range).
The agent fetches the file from that URL (curl, aria2, a browser, anything).
Free downloads: a few files a day, up to 2 GB, speed limited. Fast downloads use traffic from your balance. See Free vs Fast for the numbers.

Free vs Fast →

Prefer plain HTTP?

The same token works on the website's REST API. Base URL: https://fetchpan.com/v1/web, header Authorization: Bearer YOUR_TOKEN.

POST /jobs	Start a job. Body: {"url": "…", "password": "…"}
GET /jobs/{id}	Job status and offers.
POST /jobs/{id}/download	Get the URL. Body: {"tier": "free"} or {"tier": "fast"}
GET /session	Account, balance and free limits.
GET /account	Balance and recent orders and downloads.
GET /sites, GET /hosts	Supported sites with live status.
GET /packages, POST /orders	Traffic packs; create a payment page.

Good to know

A token acts as you. If it leaks, delete it above: it stops working at once.
Limits are the website's: up to 10 new links per hour per account, free files per day as shown on Free vs Fast, 2 GB per free file.
Errors come back as a code and a sentence, for example sign_in_required, daily_limit, too_many_links, not_ready, insufficient_balance. Free-limit errors say when to retry.
Only download files you have the right to. See Copyright / abuse. We do not host files; we open the link you give.

Questions

What is the FetchPan MCP server?

A Model Context Protocol server at https://fetchpan.com/mcp. It gives an AI agent nine tools to check a link, fetch it from a supported file host or Chinese cloud drive, and get a download URL.

How do I add FetchPan to Codex?

Create a token on this page, export it as FETCHPAN_TOKEN, and add a [mcp_servers.fetchpan] block with url = "https://fetchpan.com/mcp" and bearer_token_env_var = "FETCHPAN_TOKEN" to ~/.codex/config.toml. Then run /mcp in Codex to check.

How do I add FetchPan to WorkBuddy?

In WorkBuddy open Connectors, Custom connector, Configure MCP, and add a fetchpan entry with type http, the URL https://fetchpan.com/mcp and an Authorization header "Bearer YOUR_TOKEN" to mcp.json. Save, then switch it on in My MCP.

Is it free?

Creating a token is free. Downloads use your account's free files each day (a few files, up to 2 GB, speed limited) or traffic you bought. The agent can tell you which one a download would use before it spends anything.

Does FetchPan host the files?

No. It opens the link you give it and returns a temporary URL on fetchpan.com that works for 12 hours. Only download files you have the right to.

Is my token safe?

We store only a fingerprint of it, so it is shown once. Anyone who has the token can use your free files and traffic, so keep it private. You can delete it on this page and it stops working at once.

Can I add it to ChatGPT or claude.ai as a connector?

Not yet. Those connectors need OAuth sign-in, and FetchPan uses a Bearer token. Use Codex, WorkBuddy, Claude Code or any client that lets you set an Authorization header.

Questions or something missing?

Tell us on the feedback page what your agent needs. We read every message. Send feedback →