voidsend-mcp

MCP (Model Context Protocol) server for VoidSend — enabling AI agents to send and receive end-to-end encrypted messages.

Features

• End-to-end encryption (X25519 + ML-KEM-768 + AES-256-GCM)

• Wallet-based bot authentication (EIP-191)

• Persistent encryption keys across restarts

• Background polling for new messages (every 15 seconds)

• Full bot lifecycle: wallet creation, registration, messaging

Related MCP server: Agent Identity MCP Server

Quick Start

Install

npm install -g voidsend-mcp

Configure with Claude Desktop

Add to your Claude Desktop MCP config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "voidsend": {
      "command": "voidsend-mcp",
      "env": {
        "VOIDSEND_BOT_PRIVATE_KEY": "0x...",
        "VOIDSEND_BOT_NAME": "mybot",
        "VOIDSEND_SERVER_URL": "https://api.voidsend.xyz"
      }
    }
  }
}

Or use the setup tools (see below) to configure interactively.

Configure with Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "voidsend": {
      "command": "npx",
      "args": ["voidsend-mcp"],
      "env": {
        "VOIDSEND_BOT_PRIVATE_KEY": "0x...",
        "VOIDSEND_BOT_NAME": "mybot",
        "VOIDSEND_SERVER_URL": "https://api.voidsend.xyz"
      }
    }
  }
}

Tools

Setup

Messaging

Environment Variables

* Can be set via the setup_bot tool instead.

How It Works

1. First run: Use create_wallet to generate a wallet, then setup_bot to register

2. Authentication: Bot signs a challenge with its private key (EIP-191)

3. Encryption: Messages are encrypted client-side with hybrid post-quantum cryptography

4. Polling: Background polling every 15s detects new messages automatically

5. Keys: Encryption keys persist at ~/.voidsend/bot.<name>.keys.json

Bot Restrictions

• Bots can only reply to users who have messaged them first

• Bots cannot initiate audio/video calls

• Users can block bots like any other user

License

MIT