$ Documentation

uldl.sh is a text and file upload service optimized for terminal usage. Upload files via curl, get a shareable URL back. No browser required.

There are three ways to upload content to uldl.sh. All methods POST to your username endpoint.

Method 1: Pipe from stdin

Pipe any command output directly to uldl.sh.

Method 2: Multipart file upload

Upload a file with its original filename preserved.

Method 3: Raw body upload

Upload file contents directly as the request body.

Access your blobs via GET request to the returned URL.

List all your blobs via an authenticated GET request to your username endpoint. Returns a JSON array of blob metadata.

Query Parameters

Response Format

Returns a JSON array of blob objects. Each object contains metadata only — no file content.

[
  {
    "slug": "abc123",
    "title": "My Config",
    "filename": "config.yaml",
    "mimeType": "text/yaml",
    "sizeBytes": 1234,
    "language": "yaml",
    "visibility": "private",
    "tags": ["config", "production"],
    "createdAt": "2026-03-28T12:00:00.000Z",
    "updatedAt": "2026-03-28T12:00:00.000Z"
  }
]

Customize your uploads with these optional headers.

Blobs are private by default. Public blobs can be accessed by anyone with the URL. Private blobs require your authentication key.

Your access key is a unique 24-character token generated when you sign up. Find it in your dashboard by clicking the curl command button. Use it to access private blobs and delete blobs.

Every blob maintains a version history. Update a blob via PUT to create a new version. The latest version is always served by default.

Via MCP, pass the slug parameter to the upload tool to update an existing blob instead of creating a new one.

Version history can be viewed and managed from your dashboard.

Delete blobs via DELETE request with your authentication key.

This removes the blob and all its versions. The storage space is immediately freed.

uldl.sh returns useful metadata in response headers.

uldl.sh uses standard HTTP status codes.

Current service limits:

uldl.sh supports the Model Context Protocol (MCP) — an open standard for connecting AI agents to external tools and data sources. Connect your AI coding assistant to uldl and it can upload, download, search, and manage files on your behalf.

Why give your AI agent blob storage?

Connecting

You need your username and access key (available in the dashboard). Then pick your client:

Claude Code

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "uldl": {
      "type": "http",
      "url": "https://uldl.sh/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_KEY",
        "x-uldl-username": "YOUR_USERNAME"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "uldl": {
      "type": "http",
      "url": "https://uldl.sh/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_KEY",
        "x-uldl-username": "YOUR_USERNAME"
      }
    }
  }
}

Available Tools

Once connected, your AI agent has access to these tools:

Example Usage

Once connected, just ask your AI agent in natural language:

Common use cases and shell integrations.

Share error logs

Share command output

Share git diff

Shell alias

Private environment template