mcpField
B
Bitatlas

Bitatlas

Local
github.com/bitatlas-groupFiles & Storage2Updated 6d ago
Repository

About Bitatlas

Bitatlas MCP Server lets AI agents work with a BitAtlas encrypted cloud drive, for tasks involving sensitive files. Files are encrypted client-side and decrypted locally by the agent; the server can also create share links for people.

Key features

  1. 01List and search file metadata
  2. 02Upload, download, and delete files
  3. 03Encrypt client-side and decrypt locally
  4. 04Create folders
  5. 05Create, list, and revoke share links

Use cases

  1. 01Let an AI agent store or retrieve files
  2. 02Decrypt vault files locally
  3. 03Hand off a file through a share link

MCP support

The MCP server exposes BitAtlas vault tools for AI agents, including file browsing, search, upload, download, deletion, and sharing.

#mcp#document-storage#encryption#zero-knowledge#vault#ai-agent#privacy#e2e-encryption#aes-256-gcm#cloud-storage#gdpr#european#file-management

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "bitatlas": {
      "command": "npx",
      "args": [
        "-y",
        "@bitatlas/mcp-server"
      ],
      "env": {
        "BITATLAS_API_KEY": "<BITATLAS_API_KEY>",
        "BITATLAS_MASTER_KEY": "<BITATLAS_MASTER_KEY>",
        "BITATLAS_API_URL": "<BITATLAS_API_URL>",
        "BITATLAS_WEB_URL": "<BITATLAS_WEB_URL>"
      }
    }
  }
}
Run commandnpx -y @bitatlas/mcp-server
Environment variables to set
BITATLAS_API_KEYSecretYour BitAtlas API key (starts with ba_). Generate one at https://bitatlas.com/vault/settings
BITATLAS_MASTER_KEYSecretYour hex-encoded 256-bit master key (64 hex chars). Required for file upload and download. Derived from your password client-side — never sent to BitAtlas servers.
BITATLAS_API_URLBitAtlas API base URL (default: https://api.bitatlas.com)
BITATLAS_WEB_URLWeb origin used to build share links (default: https://www.bitatlas.com)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@bitatlas/mcp-server1.1.0

Tools

10

Saved tool list · updated 3w ago

This tool takes no parameters.

Details

From the project README

BitAtlas MCP Server 🤖

Zero-Knowledge Cloud Drive persistence for AI agents.

This Model Context Protocol (MCP) server allows AI agents to securely interact with the BitAtlas vault. All files are encrypted client-side, meaning the server never sees the plaintext data.

Features

  • Search & List Vault: Agents can browse encrypted file metadata.
  • Secure Retrieval: Agents can fetch encrypted blobs and decryption metadata.
  • Zero-Knowledge: The agent performs decryption locally using the user's provided master key.
  • Hand a file to a human: bitatlas_share_file mints a public link the host cannot read — the decryption key rides in the URL fragment, never reaching BitAtlas. The canonical "agent produces an artifact → human opens a link" handoff, without giving up zero knowledge.

Tools

ToolPurpose
bitatlas_vault_statusVault health, file count, storage usage
bitatlas_list_filesList file metadata (filter by folder/category/search)
bitatlas_searchSearch files by name
bitatlas_get_fileDownload + decrypt a file's content
bitatlas_upload_fileEncrypt a local file client-side and upload it
bitatlas_delete_fileDelete a file
bitatlas_create_folderCreate a folder
bitatlas_share_fileCreate a public, zero-knowledge share link (/s/<id>#k=…) to hand a file to a human. ⚠️ Anyone with the link can read the file.
bitatlas_list_sharesList your share links with expiry, download count, and status
bitatlas_revoke_shareRevoke a share link (stops future downloads)

Installation

For AI Agents (Claude Desktop, OpenClaw, etc.)

Add this to your MCP settings:

{
  "mcpServers": {
    "bitatlas": {
      "command": "npx",
      "args": ["-y", "@bitatlas/mcp-server"],
      "env": {
        "BITATLAS_API_KEY": "your-api-key",
        "BITATLAS_MASTER_KEY": "your-derived-master-key"
      }
    }
  }
}
x402 Wallet Mode (No Account Required)

Instead of an API key, agents can pay per request using a crypto wallet with USDC on Base:

{
  "mcpServers": {
    "bitatlas": {
      "command": "npx",
      "args": ["-y", "@bitatlas/mcp-server"],
      "env": {
        "BITATLAS_WALLET_PRIVATE_KEY": "0xabc...",
        "BITATLAS_MASTER_KEY": "your-64-hex-char-master-key"
      }
    }
  }
}

No signup. No API key. The agent pays per request in USDC and gets full vault access. Files include 30 days of storage and can be renewed.

Priority: If both BITATLAS_API_KEY and BITATLAS_WALLET_PRIVATE_KEY are set, the API key is preferred (free within quota).

Environment Variables

VariableRequiredDescription
BITATLAS_API_KEYOne of API key or walletPersonal access token from bitatlas.com
BITATLAS_WALLET_PRIVATE_KEYOne of API key or walletEVM private key for x402 payments
BITATLAS_MASTER_KEYFor encrypt/decrypt64-char hex string (256-bit master key)
BITATLAS_API_URLNoDefaults to https://api.bitatlas.com
BITATLAS_WEB_URLNoWeb origin used to build share links. Defaults to https://www.bitatlas.com

Development

npm install
npm run start

License

MIT

Comments

Markdown supported

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.