---
name: Fairdrop
version: 0.1.0
description: Privacy-first encrypted file sharing and data exchange on Ethereum Swarm
metadata:
  mcp_server: https://mcp.fairdrop.xyz/
  transport: streamable-http
  website: https://fairdrop.xyz
  github: https://github.com/fairDataSociety/fairdrop
---

# Fairdrop — Share files. Not data.

Privacy-first encrypted file sharing on Ethereum Swarm. No tracking. No metadata. No backdoors. Files encrypted client-side with AES-256-GCM before upload. Fairdrop never sees your data.

## Quick Start for AI Agents

### Streamable HTTP (recommended)

```json
{
  "mcpServers": {
    "fairdrop": {
      "url": "https://mcp.fairdrop.xyz/mcp"
    }
  }
}
```

### stdio (local)

```json
{
  "mcpServers": {
    "fairdrop": {
      "command": "npx",
      "args": ["-y", "@fairdrop/mcp"]
    }
  }
}
```

## Tools

### Status & Lookup

| Tool | Description |
|------|-------------|
| `fairdrop_status` | Check connection status and get setup instructions |
| `fairdrop_lookup` | Resolve ENS name to address and public key |

### File Operations

| Tool | Description |
|------|-------------|
| `fairdrop_upload` | Upload file to Swarm (optionally encrypted) |
| `fairdrop_download` | Download file from Swarm |
| `fairdrop_download_bytes` | Download file and return as base64 (max 10MB) |
| `fairdrop_send_anonymous` | Send file anonymously to recipient (sender identity hidden) |

### Access Control (ACT)

| Tool | Description |
|------|-------------|
| `fairdrop_act_upload` | Upload file with ACT access control (only specified grantees can decrypt) |
| `fairdrop_act_download` | Download ACT-protected content (requires grantee access) |
| `fairdrop_act_grant` | Add grantees to existing ACT-protected content |
| `fairdrop_act_revoke` | Revoke access from grantees |
| `fairdrop_act_list` | List current grantees for ACT-protected content |

### Escrow (Trustless Data Exchange)

| Tool | Description |
|------|-------------|
| `fairdrop_prepare_escrow` | Encrypt data, upload to Swarm, return unsigned create-escrow tx |
| `fairdrop_prepare_fund` | Prepare fund escrow transaction (buyer) |
| `fairdrop_prepare_commit` | Prepare commit key release transaction (seller, phase 1) |
| `fairdrop_prepare_reveal` | Prepare reveal key transaction (seller, phase 2) |
| `fairdrop_prepare_claim` | Prepare claim payment or claim expired transaction |
| `fairdrop_prepare_dispute` | Prepare dispute transaction (buyer) |
| `fairdrop_submit_tx` | Submit signed transaction to the chain |
| `fairdrop_escrow_verify` | Verify escrow content hash and details before funding |
| `fairdrop_escrow_status` | Get detailed escrow status and audit trail |
| `fairdrop_escrow_list` | List escrows by address (as seller or buyer) |
| `fairdrop_escrow_next_action` | Get exact next action for escrow based on current state |
| `fairdrop_check_sales` | Check sales status for listed skills |

### Configuration

| Tool | Description |
|------|-------------|
| `fairdrop_assign_stamp` | Assign postage stamp batch for uploads |

## Architecture

### Keyless Gateway

The MCP server at `mcp.fairdrop.xyz` is a keyless gateway. It holds no private keys. Escrow operations use a sign-submit pattern:

```
fairdrop_prepare_*() → sign externally → fairdrop_submit_tx()
```

This means the agent (or its identity provider) retains full custody of keys.

### Two-MCP Pattern

For full identity management, pair Fairdrop with the FDS Identity MCP server:

```json
{
  "mcpServers": {
    "fairdrop": { "url": "https://mcp.fairdrop.xyz/mcp" },
    "fds-id": { "command": "npx", "args": ["-y", "@fds/identity-mcp"] }
  }
}
```

Use `fds_id_sign_transaction()` from fds-id to sign prepared transactions from Fairdrop.

## Skill Exchange / Escrow

Fairdrop enables trustless data exchange between agents via on-chain escrow:

1. **Seller** encrypts data and creates escrow (`fairdrop_prepare_escrow`)
2. **Buyer** verifies and funds escrow (`fairdrop_prepare_fund`)
3. **Seller** commits then reveals decryption key (`fairdrop_prepare_commit` + `fairdrop_prepare_reveal`)
4. **Seller** claims payment (`fairdrop_prepare_claim`)

Disputes are handled on-chain. No intermediary required.

## Links

- Website: https://fairdrop.xyz
- GitHub: https://github.com/fairDataSociety/fairdrop
- MCP Server: https://mcp.fairdrop.xyz/
- Fair Data Society Principles: https://principles.fairdatasociety.org