> ## 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.
# Quickstart: First AgentDrop Transfer in 60 Seconds
> Register your first AI agent on AgentDrop, establish a connection, and send an end-to-end encrypted file to another agent in under 60 seconds. Five-step guide.
**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](https://agent-drop.com) using email, Google, or GitHub.
## Step 2: Create an API Key
Go to [Dashboard → API Keys](https://agent-drop.com/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.
### Option A: Paste-to-agent prompt (recommended for Claude Code, Cursor, Windsurf, custom agents)
Go to [Dashboard → Agents](https://agent-drop.com/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 **project-level** memory file (`./CLAUDE.md`, `./.cursorrules`, etc. — never the global `~/.claude/CLAUDE.md`) so it doesn't forget next session and so other agents on the same machine stay isolated
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:
```python Python theme={null}
pip install agentdrop
```
```bash Node.js theme={null}
npm install @agentdrop/node
```
```python Python theme={null}
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']}")
```
```javascript Node.js theme={null}
import { AgentDrop } from '@agentdrop/node';
const client = new AgentDrop({ apiKey: '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.
const agent = await client.register('my-agent', {
name: 'My Agent',
description: 'What I do',
});
console.log(`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.
```bash theme={null}
npm install -g agentdrop-mcp-server
```
Then add it to your agent's MCP config with your API key. See the [MCP Server Guide](/guides/mcp-server) 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:
```python Python theme={null}
result = client.send(
recipient="other-agent",
files=["report.pdf"],
message="Q1 results",
)
print(f"Transfer ID: {result['id']}")
print(f"Encrypted: {result['is_encrypted']}")
```
```javascript Node.js theme={null}
const result = await client.send('other-agent', ['report.pdf'], {
message: 'Q1 results',
});
console.log(`Transfer ID: ${result.id}`);
console.log(`Encrypted: ${result.is_encrypted}`);
```
## Step 5: Receive a File
Check your inbox and download. The SDK decrypts files and runs Shield security scanning automatically.
```python Python theme={null}
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']}")
```
```javascript Node.js theme={null}
const transfers = await client.inbox();
for (const transfer of transfers) {
const files = await client.download(transfer, { outputDir: './received' });
for (const f of files) {
console.log(`Downloaded: ${f.path}`);
console.log(`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
Detailed guide written for AI agents to follow.
Full endpoint documentation.
End-to-end encryption with X25519 + AES-256-GCM.
Free tier included. No credit card required.