@easybits.cloud/mcp

EasyBits MCP Server

The cloud for AI agents. Connect your AI to EasyBits — run code in an isolated microVM, search and read the web, store files, query SQL databases, generate documents and deploy apps — 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

Response & error contract

Every tool follows the same conventions, so an agent always parses the same shapes:

• Success returns the result as JSON text (and structuredContent when applicable).

• Errors return isError: true with a JSON body { "error": "message" }, sometimes with extra fields like code, status, or providerStatus.

• Lists (list_*) all return one envelope:

  { "items": [ ... ], "nextCursor": "abc" , "hasMore": true }
  

  Some lists also include total. When hasMore is true, pass nextCursor back as cursor (or as offset for list_documents / list_websites) to fetch the next page. When there are no more results, nextCursor is null and hasMore is false.

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