# n1stake Sui Faucet — Full Documentation

Free Sui **testnet** faucet run by n1stake (https://n1stake.com), a validator on Sui, Walrus, and IKA.

- Web faucet: https://faucet.n1stake.com — paste a Sui address, solve a captcha, receive 1 testnet SUI
- Agent faucet: hosted MCP server at `https://mcp.n1stake.com/mcp` — AI assistants claim on the user's behalf
- Amount: 1 testnet SUI per web claim or 5 testnet SUI per MCP/agent claim — both share one 24-hour wallet and IP cooldown
- Testnet tokens have no monetary value; they pay gas for testing on the Sui test network

## Claiming via the web UI (humans)

1. Open https://faucet.n1stake.com
2. Paste your Sui wallet address (0x…)
3. Complete the captcha and click Claim — the payout is queued for delivery
4. Come back every 24 hours, or earn more by completing tasks (staking WAL/SUI to n1stake, builder proof)

## Claiming via MCP (AI agents)

### 1. Get an API key

1. Visit https://faucet.n1stake.com/agent
2. Connect your Sui wallet and sign a free message (no gas, no transaction)
3. Copy your `n1s_…` API key — shown once. Keys are bound to your wallet; tokens always go
   to the wallet that signed up. Re-signing rotates the key. One key per IP per 24 hours.

### 2. Add the server to your client

**Claude Code**

```bash
claude mcp add --transport http n1stake-faucet https://mcp.n1stake.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
```

**Claude Desktop** — add to `claude_desktop_config.json` (bridges the remote HTTP server
with mcp-remote; requires Node.js), then restart Claude Desktop:

```json
{
  "mcpServers": {
    "n1stake-faucet": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.n1stake.com/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
    }
  }
}
```

**Cursor** — add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "n1stake-faucet": {
      "url": "https://mcp.n1stake.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

**VS Code (Copilot agent mode)** — add to `.vscode/mcp.json`:

```json
{
  "servers": {
    "n1stake-faucet": {
      "type": "http",
      "url": "https://mcp.n1stake.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

**ChatGPT Codex (CLI and IDE extension)** — add to `~/.codex/config.toml`, then restart Codex:

```toml
[mcp_servers.n1stake-faucet]
url = "https://mcp.n1stake.com/mcp"
http_headers = { "Authorization" = "Bearer YOUR_API_KEY" }
```

**Claude API (MCP connector)** — attach the faucet to a Messages API request:

```bash
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Claim my testnet SUI."}],
    "mcp_servers": [{"type": "url", "url": "https://mcp.n1stake.com/mcp", "name": "n1stake-faucet", "authorization_token": "YOUR_API_KEY"}],
    "tools": [{"type": "mcp_toolset", "mcp_server_name": "n1stake-faucet"}]
  }'
```

**Any other MCP client** — remote HTTP server with a custom header. For stdio-only clients,
bridge with `npx mcp-remote https://mcp.n1stake.com/mcp --header "Authorization: Bearer YOUR_API_KEY"`.

### 3. Use it

Ask your assistant: "claim my testnet SUI". The payout is queued for the bound wallet.

### MCP tools

| Tool | What it does |
|---|---|
| `claim_testnet_sui` | Queues a testnet SUI transfer to your bound wallet. One 24-hour wallet and IP cooldown, shared with the web faucet. |
| `check_claim_status` | Tells you whether you can claim now, or how long until the next claim. |

## Networks: testnet vs devnet vs mainnet

- **Testnet** — what this faucet dispenses. The stable Sui network for testing dApps.
- **Devnet** — bleeding-edge network that resets frequently. Not served by this faucet;
  request devnet SUI from the Sui CLI with `sui client faucet` while connected to devnet.
- **Mainnet** — real SUI with market value. There is no mainnet faucet (any site claiming
  otherwise is a scam). Buy SUI on an exchange, then stake it with n1stake at
  https://faucet.n1stake.com/staking to earn native rewards.

## Limits & fair use

- 1 claim (5 SUI) per wallet and IP per 24 hours, shared with the web faucet
- 30 attempts per API key per hour
- 1 API key minted per IP per 24 hours
- Service may pause automatically under abnormal load

## Other pages

- Staking (mainnet SUI/WAL/IKA to n1stake): https://faucet.n1stake.com/staking
- Sui testnet weekly digest: https://faucet.n1stake.com/testnet-digest

Maintained by n1stake — https://n1stake.com · Twitter: @n1stake