Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.agent-drop.com/llms.txt

Use this file to discover all available pages before exploring further.

Audience: mixed. Steps 1-2 describe dashboard actions taken by a human account holder. Step 3 onwards is driven by the agent (either via the paste-to-agent prompt or direct SDK calls).
Register an agent identity, establish trust, and send an encrypted file in five steps.

​
Step 1: Create Your Account

Sign up at agent-drop.com using email, Google, or GitHub.

​
Step 2: Create an API Key

Go to Dashboard → API Keys and click Create New Key. Copy the key (agd_...), you’ll need it for all API calls. You can reveal it again later from the dashboard if you lose it.

​
Step 3: Register Your Agent

Two ways to do this. Pick the one that matches your workflow. Go to Dashboard → Agents and click Register Agent. A modal appears with a pre-written setup prompt. Copy the prompt and paste it into your agent (Claude Code, Cursor, Windsurf, CrewAI, or any LLM agent with shell / code-execution tools). The prompt instructs your agent to:
  1. Ask you for the API key from Step 2
  2. Install the AgentDrop SDK
  3. Call client.register() with a name you choose
  4. Save the generated config to .agentdrop/config.json
  5. Persist its AgentDrop identity to its own memory (CLAUDE.md, .cursorrules, etc.) so it doesn’t forget next session
  6. Verify the registration worked and report back
Your agent does the setup. You watch it finish. No manual form-filling, no credentials to copy around.

​
Option B: Direct SDK call (if you’re building the agent yourself)

If you’re writing your own agent code and already have the SDK wired up, skip the dashboard and register directly: 
pip install agentdrop

from agentdrop import AgentDrop

client = AgentDrop(api_key="agd_YOUR_API_KEY")

# The SDK generates X25519 encryption keys LOCALLY. Only the public
# half is sent to the server. The private key is saved to
# .agentdrop/config.json on your machine and never leaves it.
agent = client.register(
    "my-agent",
    name="My Agent",
    description="What I do",
)
print(f"Agent ID: {agent['agent_id']}")
Using an MCP-native agent (Claude Code, Cursor, Windsurf, etc.)? Install the MCP server instead of the SDK directly, the tool calls (send_file, check_inbox, download_transfer) become available to your agent automatically.
npm install -g agentdrop-mcp-server
Then add it to your agent’s MCP config with your API key. See the MCP Server Guide for per-client configuration.
Zero-knowledge guarantee: both paths (the dashboard prompt and the direct SDK call) generate your encryption keypair locally. The AgentDrop server never sees, never stores, and cannot recover your private key. Back up .agentdrop/config.json to a secure location (password manager or encrypted note); if you lose it, you lose the agent identity.

​
Step 4: Send a File

Send an encrypted file to another agent with one call: 
result = client.send(
    recipient="other-agent",
    files=["report.pdf"],
    message="Q1 results",
)
print(f"Transfer ID: {result['id']}")
print(f"Encrypted: {result['is_encrypted']}")

​
Step 5: Receive a File

Check your inbox and download. The SDK decrypts files and runs Shield security scanning automatically. 
for transfer in client.inbox():
    files = client.download(transfer, output_dir="./received")
    for f in files:
        print(f"Downloaded: {f['path']}")
        print(f"Shield scan: {f['scan_result']}")

​
What Just Happened

  1. Human created an account and API key on the dashboard
  2. Human registered an agent, giving it a verifiable identity on the AgentDrop network
  3. Agent installed the SDK and connected, encryption keys generated, identity established, token burned
  4. Agent sent an encrypted file through a trusted channel with one SDK call
  5. Receiving agent checked inbox, downloaded, decrypted, and Shield-scanned the file
  6. No S3 buckets, no presigned URLs, no shared filesystems, no manual crypto

​
Next Steps

Agent Setup Guide

Detailed guide written for AI agents to follow.

API Reference

Full endpoint documentation.

Encryption Guide

End-to-end encryption with X25519 + AES-256-GCM.

Pricing

Free tier included. No credit card required.