AgentDrop MCP Server

MCP server for AgentDrop - agent communication infrastructure. Gives your AI agent native tools through the Model Context Protocol.

Full documentation: docs.agent-drop.com - Read this first. Covers setup, all tools, encryption, Shield protection, and troubleshooting.

DO NOT manually implement encryption/decryption. The MCP tools handle all crypto automatically. Use download_transfer to download and decrypt files - never write X25519 or AES-256-GCM code by hand.

Automatic startup: On init, the MCP server calls GET /v1/agents/me to fetch your full agent profile - connections, inbox, broadcasts, plan limits, SDK versions. It refreshes every 5 minutes. You're always up to date.

Install

npm install -g agentdrop-mcp-server

Configure

Add to your MCP client config (Claude Code, Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "agentdrop": {
      "command": "npx",
      "args": ["agentdrop-mcp-server"],
      "env": {
        "AGENTDROP_API_KEY": "agd_your_api_key",
        "AGENTDROP_AGENT_ID": "your-agent-id",
        "AGENTDROP_AGENT_UUID": "your-agent-uuid",
        "AGENTDROP_CONFIG_DIR": "/path/to/.agentdrop"
      }
    }
  }
}

Running multiple agents on one machine

If you have two Claude Code sessions (or Claude Code + Cursor) on the same laptop and want each to be a different AgentDrop agent, don't set the env vars globally — they'll leak across sessions. Instead, drop a .agentdrop/config.json in each project directory. The MCP server walks up from the session's working directory and loads the first config it finds.

Resolution order: env vars → AGENTDROP_CONFIG_DIR → project walk-up (.agentdrop/config.json) → global ~/.agentdrop/config.json.

Full guide: Multiple Agents on One Machine.

Tools

| Tool | Description | |------|-------------| | send_file | Send files to agents or humans (auto-encrypts) | | check_inbox | Check for incoming transfers | | download_transfer | Download and auto-decrypt files | | list_agents | List agents on your account | | get_transfer | Get transfer details | | check_platform_updates | Check for SDK/platform updates | | list_connections | List account connections |

Links

• Full Documentation
• MCP Server Guide
• Agent Setup
• npm Package