Skip to main content
Glama
Pandafile MCP Server

Pandafile MCP Server

Official
by pandafileco

@pandafile/mcp

The official Model Context Protocol server for Pandafile. It lets AI agents – Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and any other MCP client – send big files and folders with a link, and manage your transfers and file requests.

"Send the renders/ folder to client@example.com with Pandafile, title it Final renders, keep it for 60 days."

The agent calls send_files, the files are uploaded with resumable, chunked uploads (any size your plan allows), and you get the link back: https://pandafile.co/d/k3x9q2m7ab.

  • Runs locally over stdio (npx -y @pandafile/mcp); Node 18 or newer.

  • Built on the official @pandafile/sdk: retries, idempotency keys, resumable tus uploads.

  • Progress notifications while uploading, readable errors (the API's own message), no crashes on API errors.

Requirements

  • A Pandafile Pro or Team plan (the API is included) and an API key from Dashboard → Domain & API.

  • Node.js 18+ (npx comes with it).

Use a test key (pf_test_…) while you try it out: transfers are real uploads, but nobody is emailed, they expire after 24 hours and count toward no limit. File requests need a live key (pf_live_…).

Related MCP server: justdrop-mcp

Install

Replace pf_live_YOUR_KEY with your key in each example.

Claude Desktop

Settings → Developer → Edit Config (claude_desktop_config.json):

{
  "mcpServers": {
    "pandafile": {
      "command": "npx",
      "args": ["-y", "@pandafile/mcp"],
      "env": { "PANDAFILE_API_KEY": "pf_live_YOUR_KEY" }
    }
  }
}

Restart Claude Desktop. The file is in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.

Claude Code

claude mcp add pandafile --env PANDAFILE_API_KEY=pf_live_YOUR_KEY -- npx -y @pandafile/mcp

Add --scope user to have it in every project.

Cursor

.cursor/mcp.json in your project (or ~/.cursor/mcp.json for every project):

{
  "mcpServers": {
    "pandafile": {
      "command": "npx",
      "args": ["-y", "@pandafile/mcp"],
      "env": { "PANDAFILE_API_KEY": "pf_live_YOUR_KEY" }
    }
  }
}

VS Code (GitHub Copilot agent mode)

.vscode/mcp.json – VS Code asks for the key once and stores it securely:

{
  "inputs": [
    { "type": "promptString", "id": "pandafile-api-key", "description": "Pandafile API key (pf_live_… or pf_test_…)", "password": true }
  ],
  "servers": {
    "pandafile": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@pandafile/mcp"],
      "env": { "PANDAFILE_API_KEY": "${input:pandafile-api-key}" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "pandafile": {
      "command": "npx",
      "args": ["-y", "@pandafile/mcp"],
      "env": { "PANDAFILE_API_KEY": "pf_live_YOUR_KEY" }
    }
  }
}

Other clients (ChatGPT, Codex, Zed, …)

Any client that starts local (stdio) MCP servers works with the command npx -y @pandafile/mcp and the environment variable PANDAFILE_API_KEY. For example the OpenAI Codex CLI:

codex mcp add pandafile --env PANDAFILE_API_KEY=pf_live_YOUR_KEY -- npx -y @pandafile/mcp

ChatGPT's connectors talk to remote (HTTPS) MCP servers; this package is a local server, so use it from a client that runs local servers.

Configuration

Variable

PANDAFILE_API_KEY

Required. pf_live_…, or pf_test_… for test mode. Without it the server still starts, and every tool answers with setup instructions.

PANDAFILE_BASE_URL

Optional. Default https://pandafile.co/api/v1. Only for testing against a local Pandafile server.

Tools

Tool

What it does

send_files

Upload local files and folders (absolute paths; folders keep their structure) and get the link. Options: title, message, recipients, expires_in_days / expires_at, password. Sends MCP progress notifications when the client asks for them.

writes

send_from_urls

Make a transfer from public https URLs – Pandafile downloads them itself. Returns ready, or uploading with a hint to call get_import_status.

writes

get_import_status

Progress of a send_from_urls transfer.

read-only

list_transfers

Your transfers, newest first: search (query), view active/history, limit, cursor.

read-only

get_transfer

One transfer: files, recipients (who downloaded), latest downloads, approvals, link statistics.

read-only

add_recipients

Email the link to more people.

writes

remind_recipient

Email a recipient their link again.

writes

update_transfer

Title, message, later expiry, set or remove the password.

writes

delete_transfer

Delete a transfer and its files now.

destructive

create_file_request

An upload page others can send you files with.

writes

list_file_requests

Your file requests and their uploads.

read-only

close_file_request

Stop a file request from taking uploads.

writes

get_account

Plan, limits, usage and whether the key is a test key.

read-only

Every tool carries MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), so clients can ask before anything that changes or deletes data. API errors come back as tool errors with Pandafile's message, error code and request id.

Privacy and security

  • Files go only to Pandafile (pandafile.co, or PANDAFILE_BASE_URL if you set it). Pandafile's servers are in Helsinki, Finland (EU). See the privacy policy.

  • The server reads only the paths the agent passes to send_files. It collects no telemetry.

  • The API key is sent only to the Pandafile API, never logged and never included in tool results. Diagnostics go to stderr; stdout carries only MCP messages.

  • Give the agent a key with the narrowest scope that works (keys can be read, write or full), or a test key while you experiment.

Development

npm install
npm test                 # unit tests: mocked API, in-memory MCP client
npm run test:e2e         # end to end inside the Pandafile repository: real server + throwaway database, stdio

MIT © 3XAYA LTD

Available Tools

13 tools
add_recipientsAdd recipientsA
Idempotent

Email the transfer's link to more people: each new address gets an email with a personal download link. Addresses already on the transfer are skipped.

Inputs: id (required), emails (required).

close_file_requestClose a file requestA
Idempotent

Stop a file request from accepting uploads (its upload page then says it is closed). Files already uploaded stay. It can be reopened from the dashboard.

Inputs: id (required).

create_file_requestCreate a file requestA

Create a file request: an upload page (link) anyone can use to send files to this account – e.g. to collect photos or documents from a client. Uploads show up as transfers. Needs a live key on Pro/Team.

Inputs: title (required), message.

delete_transferDelete a transferA
DestructiveIdempotent

Delete a transfer now: its files are removed for good and the link stops working for everyone. This cannot be undone – confirm with the user first.

Inputs: id (required).

get_accountAccount, plan and usageA
Read-onlyIdempotent

The account behind the API key: plan, limits (max bytes per transfer, expiry days, features), usage (this week / month, storage) and whether the key is a test key.

Inputs: no named parameters.

get_import_statusURL import statusA
Read-onlyIdempotent

Progress of a transfer created with send_from_urls: per file bytes received, then "ready" (the link works) or "failed" (with the error; the transfer is then deleted).

Inputs: id (required).

get_transferGet a transferA
Read-onlyIdempotent

One transfer in detail: link, status, expiry (and the latest expiry possible), files, recipients (who was emailed, who downloaded), latest downloads, approvals/comments from recipients and link statistics (views, downloads, countries).

Inputs: id (required).

list_file_requestsList file requestsA
Read-onlyIdempotent

The account's file requests (upload pages) with their links, whether they are open and how many uploads came in. Pass next_cursor as cursor for the next page.

Inputs: limit, cursor.

list_transfersList transfersA
Read-onlyIdempotent

The account's transfers, newest first, with link, size, expiry and download counts. view "active" (default: live and still uploading) or "history" (expired, deleted, blocked). Pass next_cursor as cursor for the next page.

Inputs: view, limit, query, cursor.

remind_recipientRemind a recipientA

Email a recipient of the transfer their personal link again (and turn their reminders back on). At most twice an hour per recipient.

Inputs: id (required), email (required).

send_filesSend files with PandafileA

Upload local files and/or folders to Pandafile and get a share link (https://pandafile.co/d/). Folders are sent with their structure. Large files are fine (resumable, chunked uploads); the call returns when the upload is complete. If recipients are given, each gets an email with a personal download link. Returns the link, id, expiry and sizes. Only send files the user asked you to send.

Inputs: paths (required), title, message, password, +3 more.

send_from_urlsSend files from URLsA

Create a Pandafile transfer from files at public https URLs: Pandafile downloads them itself (no local upload). Waits up to ~20 seconds. status "ready": the link works now. status "uploading": big files are still downloading – call get_import_status with the id until it is "ready" (or "failed"). Recipients are emailed when it is ready.

Inputs: files (required), title, message, password, +3 more.

update_transferUpdate a transferA
Idempotent

Change a live transfer: title, message, expiry (later only, Pro/Team, at most 90 days after it was sent – get_transfer shows latest_possible_expiry) and the download password (set a new one, or remove it with remove_password). Only the fields you give change.

Inputs: id (required), title, message, password, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 13 tools

    Disambiguation5/5

    Each tool maps to a distinct resource and action: transfers (send/get/list/update/delete), recipients (add/remind), imports (send_from_urls/get_import_status), and file requests (create/list/close). The potentially ambiguous pair send_files vs send_from_urls is clearly separated by source (local upload vs public HTTPS URLs), and get_transfer vs get_account vs get_import_status target different entities. No two tools could be plausibly confused in normal use.

    Naming Consistency5/5

    All 13 tools use consistent snake_case verb_noun naming (send_files, get_transfer, list_transfers, update_transfer, delete_transfer, create_file_request, close_file_request). The verb set is small and predictable — send/get/list/add/remind/update/delete/create/close — with no camelCase or stylistic mixing.

    Tool Count5/5

    13 tools sits squarely in the well-scoped range for a file-transfer service with three sub-domains (transfers, imports, file requests). Each tool covers a distinct operation and none appears redundant or like filler.

    Completeness4/5

    Transfers have full lifecycle coverage (send, list, get detail, update, delete) plus recipient management, and file requests cover create/list/close. Minor gaps remain: no remove_recipient, no get_file_request for a single upload page's detail, and no reopen_file_request (the description says reopening is dashboard-only), which slightly limits programmatic file-request management.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables AI agents to perform FTP/FTPS/SFTP file operations including upload, download, sync, and directory management with multi-server support.
      36
      70 npm
      8
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to send and receive files securely via JustDrop, with end-to-end encryption, QR codes, and no server-side storage.
      4
      143 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to securely transfer files between machines via encrypted, expiring share links, with tools for upload, download, status checks, and link management.
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      Enables AI agents to split large files, zips, or folders into size-capped parts with SHA-256 checks, verify or regenerate missing parts, and rebuild the original across platforms so handoffs respect strict per-file upload limits.
      8
      1
      -