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