io.github.bitatlas-group/bitatlas

Official

by bitatlas-group · MDX

Zero-knowledge encrypted storage for humans and AI agents. Client-side AES-256-GCM, EU-hosted.

Client-side encrypted storage with AES-256-GCM for humans and AI agents.

Topics

ai-agentsencryptionend-to-end-encryptionmcpmcp-servermodel-context-protocolvaultx402zero-knowledge

README.md3 KBView on GitHub

BitAtlas

Zero Knowledge Cloud Drive for Humans and Agents

BitAtlas is a next-generation cloud storage platform designed with privacy and AI agents in mind. It provides a secure, zero-knowledge environment where your most sensitive documents are encrypted client-side and accessible only to you and the agents you authorize.

🚀 Vision

BitAtlas aims to be the secure "atlas" for your digital life, providing a foundation for both human productivity and AI agent assistance without compromising on privacy.

✨ Key Features

🛡️ E2E Encryption (AES-256-GCM): All files are encrypted in the browser (or at the SDK level) before being uploaded. The server never sees your plaintext data or your encryption keys.
🤖 Agent-Native (MCP Server): Built from the ground up to support AI agents via the Model Context Protocol (MCP). Let your agents safely search, read, and manage your vault.
🔐 Personal Vault: A dedicated space for your most critical documents—identity papers, property deeds, medical records, and digital assets.
🇪🇺 European Data Sovereignty: All infrastructure is hosted on European soil, subject to the world's strongest privacy regulations (GDPR).
💸 Pay-per-Request (x402): Anonymous access via the x402 payment standard. Agents pay with USDC stablecoins on Base — no account, no API key, no KYC. Files include 30 days of storage with pay-to-renew. Learn more →

🏗️ Project Structure

mcp-server/: The Model Context Protocol server for integrating with AI agents like Claude Desktop, OpenClaw, and more.
sdk/encryption/: The core encryption logic used for client-side security.

🌐 Ecosystem

LegacyShield (legacyshield.eu): The first production application built on BitAtlas. A digital legacy platform and encrypted document vault for humans and their descendants.

🛠️ Getting Started

MCP Server

To use BitAtlas with your AI agent, configure the MCP server:

json

{
  "mcpServers": {
    "bitatlas": {
      "command": "npx",
      "args": ["-y", "@bitatlas/mcp-server"],
      "env": {
        "BITATLAS_API_KEY": "your-api-key",
        "BITATLAS_MASTER_KEY": "your-derived-master-key"
      }
    }
  }
}

📜 License

MIT License. See LICENSE for details.

Built with ❤️ by BitAtlas Group

Install

Configuration

Environment variables

BITATLAS_API_KEYrequiredsecret

Your BitAtlas API key (starts with ba_). Generate one at https://bitatlas.com/vault/settings

BITATLAS_MASTER_KEYsecret

Your 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_URL

BitAtlas API base URL (default: https://api.bitatlas.com)

BITATLAS_WEB_URL

Web origin used to build share links (default: https://www.bitatlas.com)

claude_desktop_config.json

{
  "mcpServers": {
    "bitatlas": {
      "command": "npx",
      "args": [
        "-y",
        "@bitatlas/mcp-server@1.1.0"
      ],
      "env": {
        "BITATLAS_API_KEY": "<YOUR_BITATLAS_API_KEY>",
        "BITATLAS_MASTER_KEY": "<YOUR_BITATLAS_MASTER_KEY>",
        "BITATLAS_API_URL": "<YOUR_BITATLAS_API_URL>",
        "BITATLAS_WEB_URL": "<YOUR_BITATLAS_WEB_URL>"
      }
    }
  }
}