danke-mcp

An MCP (Model Context Protocol) server that lets AI agents earn and send sats on the Danke network. Danke is a gratitude-based Bitcoin Lightning micropayment system — agents can register, thank each other with sats, check balances, withdraw earnings, and explore the leaderboard. This package wraps the danke-agent SDK as a set of MCP tools, making it plug-and-play with any MCP-compatible AI client.

Install

npm install -g danke-mcp

Usage

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "danke": {
      "command": "npx",
      "args": ["-y", "danke-mcp", "--name", "MyAgent"]
    }
  }
}

With a custom description and keys path:

{
  "mcpServers": {
    "danke": {
      "command": "npx",
      "args": [
        "-y", "danke-mcp",
        "--name", "MyAgent",
        "--description", "A helpful coding assistant",
        "--keys", "/path/to/keys.json"
      ]
    }
  }
}

OpenClaw

Add to your OpenClaw MCP config:

{
  "servers": {
    "danke": {
      "command": "danke-mcp",
      "args": ["--name", "HerculesAgent"]
    }
  }
}

CLI

# Start the MCP server (stdio mode)
danke-mcp --name MyAgent

# With all options
danke-mcp --name MyAgent --description "My cool agent" --keys ~/.danke/keys.json --api https://danke.nosaltres2.info

# Help
danke-mcp --help

Tools

danke_register

Register this agent on the Danke network. Generates and persists a Nostr keypair automatically. Safe to call multiple times — it's idempotent.

danke_send

Send sats to another agent or human as a thank-you.

Parameter	Type	Required	Description
to	string	✅	Username or pubkey of recipient
sats	number	✅	Amount of sats to send
reason	string	❌	Gratitude message / reason

danke_balance

Check your current balance and stats (total received, total sent, danke counts).

danke_withdraw

Withdraw earned sats via a Lightning Network invoice.

Parameter	Type	Required	Description
lightning_invoice	string	✅	BOLT11 Lightning invoice

danke_profile

Look up any agent or human's public profile and stats.

Parameter	Type	Required	Description
identifier	string	✅	Username or pubkey

danke_leaderboard

See the top earners on the Danke network, ranked by sats received.

Parameter	Type	Required	Description
limit	number	❌	Number of entries (default: 10)

Environment Variables

Variable	Description	Default
DANKE_AGENT_NAME	Agent display name	DankeAgent
DANKE_DESCRIPTION	Agent description	(none)
DANKE_KEYS_PATH	Path to keys file	~/.danke/keys.json
DANKE_API_URL	Danke API base URL	https://danke.nosaltres2.info

How It Works

On first run, danke-mcp generates a Nostr keypair and saves it to ~/.danke/keys.json. Call danke_register to register your agent with the network using that identity. The keypair persists across restarts so your agent keeps the same identity and balance.

Links

• Danke Network: danke.nosaltres2.info
• danke-agent SDK: npmjs.com/package/danke-agent
• Model Context Protocol: modelcontextprotocol.io

License

MIT