EasyBits MCP Server

Agentic-first file storage for AI agents. Connect your AI to EasyBits — upload files, manage webhooks, optimize images, deploy 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 -e EASYBITS_API_KEY=your-api-key -- npx -y @easybits.cloud/mcp

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 storage usage"
• "Optimize that PNG to WebP"
• "Set up a webhook for file uploads"
• "Bulk delete all my temp files"
• "Duplicate that config file"

Tools (31)

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) | | bulk_upload_files | Create up to 20 file records with presigned upload URLs | | bulk_delete_files | Soft-delete up to 100 files at once | | duplicate_file | Copy an existing file (creates new storage object) | | list_permissions | List sharing permissions for a file |

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 |

Webhooks

| Tool | Description | |------|-------------| | list_webhooks | List your configured webhooks | | create_webhook | Create a webhook for file/website events (returns secret) | | update_webhook | Update URL, events, or status (ACTIVE/PAUSED) | | delete_webhook | Permanently delete a webhook |

Events: file.created, file.updated, file.deleted, file.restored, website.created, website.deleted

Payloads are signed with HMAC SHA-256 via X-Easybits-Signature header. Webhooks auto-pause after 5 consecutive failures.

Account

| Tool | Description | |------|-------------| | get_usage_stats | Storage used/limit, file counts, plan info |

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

SDK

For programmatic access, use the typed SDK:

npm install @easybits.cloud/sdk

import { EasybitsClient } from "@easybits.cloud/sdk";
const eb = new EasybitsClient({ apiKey: "eb_sk_live_..." });

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

Agent Workflows

EasyBits works great alongside other AI tools. Here are common patterns for agents that have access to both EasyBits and image generation tools (like fal.ai):

Image generation → upload → share

1. Generate image with your image tool (fal.ai, DALL-E, etc.)
2. upload_file → get presigned URL → PUT the image bytes
3. Share via generate_share_token or set access to "public"
4. Send the URL to the user

Image editing pipeline

1. User sends a photo → agent saves it locally
2. Edit with fal.ai tools (bg-remove, upscale, restyle, remove-object, inpaint)
3. upload_file the result to EasyBits for permanent storage
4. Return the EasyBits URL (persistent, unlike fal.ai temp URLs)

Document with generated images

1. Generate images/graphics with image tools
2. upload_file each image to EasyBits
3. create_document with HTML sections that reference the uploaded image URLs
4. Share the document link

Website with dynamic assets

1. Generate or edit images as needed
2. upload_website_file for each asset
3. set_page_html to build pages referencing those assets
4. Deploy — user gets a live URL

Why use EasyBits for agent-generated files?

• Persistent URLs — fal.ai and other generation APIs return temporary URLs that expire. EasyBits URLs are permanent.
• Access control — set files as private, public, or share with specific users via tokens.
• Organization — search, tag, and manage all generated assets in one place.
• Webhooks — trigger downstream workflows when files are created or updated.

Links

• EasyBits
• Dashboard
• Blog

License

MIT