transfa — Claude Code MCP server for file uploads
Let an agent upload a local file and return a download link. Useful when you need to share a project artifact without uploading it yourself.
claude mcp add --env TRANSFA_API_KEY=<TRANSFA_API_KEY> --env TRANSFA_BASE_URL=<TRANSFA_BASE_URL> --transport stdio transfa -- npx -y transfa-mcpWhat transfa does
transfa gives an agent a way to send files from the local filesystem and provide download links. It calculates a SHA-256 checksum for uploads, and links have a time limit set through TTL. Start the server with npx -y transfa-mcp.
To add it to Claude Code, use claude mcp add. The install command takes a TRANSFA_API_KEY; guest mode works without one, with a 10 MB file cap and a 24h link lifetime. That cap matters if the agent needs to transfer a larger artifact.
What it helps with
- share a local project file with an agent
- create a download link for an uploaded file
- check an uploaded file's SHA-256 checksum
- set an expiry period for a file link
Example prompts for the agent
- Upload
dist/report.pdfand give me its download link. - Send
model.ggufand report its SHA-256 checksum. - Upload
archive.zipwith a 24h link lifetime.
How to install transfa
Platform CLI
claude mcp add --env TRANSFA_API_KEY=<TRANSFA_API_KEY> --env TRANSFA_BASE_URL=<TRANSFA_BASE_URL> --transport stdio transfa -- npx -y transfa-mcpReplace <…> with your own values
Platform CLI
codex mcp add transfa --env TRANSFA_API_KEY=<TRANSFA_API_KEY> --env TRANSFA_BASE_URL=<TRANSFA_BASE_URL> -- npx -y transfa-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"transfa": {
"command": "npx",
"args": [
"-y",
"transfa-mcp"
],
"env": {
"TRANSFA_API_KEY": "<TRANSFA_API_KEY>",
"TRANSFA_BASE_URL": "<TRANSFA_BASE_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"transfa": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"transfa-mcp"
],
"env": {
"TRANSFA_API_KEY": "<TRANSFA_API_KEY>",
"TRANSFA_BASE_URL": "<TRANSFA_BASE_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e TRANSFA_API_KEY=<TRANSFA_API_KEY> -e TRANSFA_BASE_URL=<TRANSFA_BASE_URL> transfa npx -y transfa-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about transfa
How do I install transfa in Claude Code?
Run claude mcp add transfa -e TRANSFA_API_KEY=<TRANSFA_API_KEY> -- npx -y transfa-mcp. This adds the transfa server to Claude Code.
What does transfa do?
It lets an agent upload files from the local filesystem and return download links. Uploaded files also get a SHA-256 checksum.
Can I run transfa without an API key?
Yes. Guest mode works without a key, with a 10 MB upload limit and a 24h link lifetime.
