About mcp-upload
mcp-upload is an MCP server for uploading files to decentralized storage, intended for Claude Desktop, Cursor, and other MCP clients. It accepts host paths or inline content and returns file metadata and a permalink.
Key features
- 01Upload files from host paths
- 02Upload files from inline content
- 03Generate a curl command for sandbox uploads
- 04Retrieve file metadata and permalinks
- 05Check storage tier pricing
Use cases
- 01Upload local files to decentralized storage
- 02Upload files from a sandbox environment
- 03Get a shareable link for an uploaded file
MCP support
The MCP server provides clients with tools for file uploads, file information, and storage pricing. An API key is required to use the service.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @objekt.sh/mcp-uploadOBJEKT_API_KEYSecretAPI key from objekt.sh/mcp (free tier available)Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
6Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | No | Filename for the upload. Auto-detected from 'path'. Required when using 'content'. |
| path | string | No | Absolute path to the file on the HOST filesystem (e.g. /Users/you/photo.png). Do NOT use container paths like /mnt/user-data/. |
| content | string | No | File content — base64-encoded for binaries, raw UTF-8 for text. Use this when the file path is not accessible from the host filesystem. |
| encoding | enum | No | Content encoding. Default 'base64'. Use 'raw' for text types like SVG, HTML, CSS, JSON.base64 | raw |
| content_type | string | No | MIME type (required with content, e.g. 'image/png'). Auto-detected when using path. |
Details
From the project README@objekt.sh/mcp-upload
MCP server for uploading files to decentralised storage from Claude Desktop, Cursor, or any MCP client.
Setup
Get a free API key at objekt.sh/mcp, then add to your MCP config:
{
"mcpServers": {
"objekt": {
"command": "npx",
"args": ["-y", "@objekt.sh/mcp-upload"],
"env": {
"OBJEKT_API_KEY": "objekt_mcp_..."
}
}
}
}
Tools
| Tool | Description |
|---|---|
upload_file | Upload by host path or inline content |
upload_from_sandbox | Returns curl command for sandbox uploads |
get_file | Get file metadata and permalink |
get_pricing | Current storage tier pricing |
Docs
objekt.sh/mcp — setup, pricing, best practices.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.