EasyBits MCP Server

Connect your AI agents to EasyBits — a digital asset marketplace for creators. Upload files, share content, optimize images, manage websites, and more — all through natural language.

Quick Start

1. Get your API key

Sign up at easybits.cloud and generate an API key from your developer dashboard.

2. Configure your client

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "easybits": {
      "command": "npx",
      "args": ["-y", "@easybits.cloud/mcp"],
      "env": {
        "EASYBITS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add easybits -- npx -y @easybits.cloud/mcp

Then set your API key in ~/.easybitsrc:

EASYBITS_API_KEY=your-api-key

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "easybits": {
      "command": "npx",
      "args": ["-y", "@easybits.cloud/mcp"],
      "env": {
        "EASYBITS_API_KEY": "your-api-key"
      }
    }
  }
}

3. Start using it

Ask your AI agent things like:

• "Upload this PDF and make it public"
• "Show me my recent files"
• "Optimize that PNG to WebP"
• "Create a share link for my latest file"
• "Search my files for invoices"

Tools (22)

Files

| Tool | Description | |------|-------------| | list_files | List files with pagination and filtering | | get_file | Get file metadata and a signed download URL (1h expiry) | | upload_file | Create a file record and get a presigned upload URL | | update_file | Update name, access level, or metadata | | delete_file | Soft-delete a file (recoverable for 7 days) | | restore_file | Restore a soft-deleted file | | list_deleted_files | List deleted files with days until permanent purge | | search_files | AI-powered natural language file search (requires AI key) |

Sharing

| Tool | Description | |------|-------------| | share_file | Share a file with another user by email | | generate_share_token | Generate a presigned download URL (60s–7 days) | | list_share_tokens | List all share tokens with expiration status |

Images

| Tool | Description | |------|-------------| | optimize_image | Convert images to WebP or AVIF with quality control | | transform_image | Resize, rotate, flip, convert format, or apply grayscale |

AI Configuration

| Tool | Description | |------|-------------| | set_ai_key | Store an AI provider API key (Anthropic/OpenAI) for search | | list_ai_keys | List configured AI keys (masked) | | delete_ai_key | Remove a stored AI key |

Storage

| Tool | Description | |------|-------------| | list_providers | List configured storage providers |

Websites

| Tool | Description | |------|-------------| | list_websites | List all websites with stats | | create_website | Create a new website with auto-generated slug | | get_website | Get website details and computed stats | | update_website | Update website name or status | | delete_website | Delete website and soft-delete associated files |

Configuration

| Variable | Description | Required | |----------|-------------|----------| | EASYBITS_API_KEY | Your EasyBits API key | Yes | | EASYBITS_URL | Custom API base URL | No |

You can also set these in a ~/.easybitsrc file:

EASYBITS_API_KEY=eb_your_key_here

Transport

This package is a stdio-to-HTTP proxy. It reads JSON-RPC messages from stdin and forwards them to the EasyBits MCP endpoint (https://www.easybits.cloud/api/mcp). Responses are streamed back via Server-Sent Events (SSE).

Requirements

• Node.js 18+
• An EasyBits account with an API key

Links

• EasyBits
• Dashboard
• Blog

License

MIT