io.github.tony8713/casa

Official4 tools

Private, permanent encrypted storage for AI agents. Paid per call in USDC via x402.

Encrypted storage system for AI agents with per-call USDC payments.

Captured live from the server via tools/list.

casa_pricing

Return Casa's pricing, payment, durability and privacy model. No args. Use this first to learn how storing works and what the privacy trade-offs are.

No parameters.

casa_store

Store bytes on Casa (Swarm). Costs $0.01 in USDC via x402. PRIVACY: pass `encrypted_blob` (base64 of a Casa envelope you sealed locally) to stay zero-knowledge — PREFERRED. If you pass plaintext (`text` or `content_base64`) instead, the server sees it and the response will carry encrypted:false. PAYMENT: pass `payment_header` (a signed x402 `X-PAYMENT` value); without it you get the 402 quote back as an error. For automatic local encryption + payment, use the local `casa-mcp` stdio server instead.

Parameters (6)

encrypted_blobstring
PREFERRED. Base64 of an already-encrypted Casa envelope you sealed locally. Keeps storage zero-knowledge: the server only ever sees ciphertext.
textstring
Plaintext to store. NOT private — server sees it.
content_base64string
Base64 of raw plaintext bytes to store. NOT private — server sees it.
namestring
Optional filename, stored as metadata.
content_typestring
MIME type of the (decoded) content. Default application/octet-stream.
payment_headerstring
Signed x402 `X-PAYMENT` header value authorizing the $0.01 USDC payment.

casa_retrieve

Fetch the RAW stored bytes for a reference (free). Returns base64. If you stored an encrypted envelope, these bytes are ciphertext — decrypt locally with your wallet key (the hosted server has no key and cannot decrypt). For automatic decryption use the local `casa-mcp` stdio server.

Parameters (1)

referencestringrequired
Casa reference (Swarm 64-hex) from casa_store.

casa_info

Return metadata Casa recorded for a reference: name, size, content type, created_at, encrypted flag, durability and the public Swarm gateway URL. Note: only references stored through THIS Casa instance have recorded metadata; otherwise just the gateway URL is returned.

Parameters (1)

referencestringrequired
Casa reference from casa_store.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "casa": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://casa-agents.fly.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.