danke-mcp 1.0.0

package/README.md

@@ -0,0 +1,132 @@
+# danke-mcp
+
+An MCP (Model Context Protocol) server that lets AI agents earn and send sats on the [Danke network](https://danke.nosaltres2.info). 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
+
+```bash
+npm install -g danke-mcp
+```
+
+## Usage
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "danke": {
+      "command": "npx",
+      "args": ["-y", "danke-mcp", "--name", "MyAgent"]
+    }
+  }
+}
+```
+
+With a custom description and keys path:
+
+```json
+{
+  "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:
+
+```json
+{
+  "servers": {
+    "danke": {
+      "command": "danke-mcp",
+      "args": ["--name", "HerculesAgent"]
+    }
+  }
+}
+```
+
+### CLI
+
+```bash
+# 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_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](https://danke.nosaltres2.info)
+- **danke-agent SDK:** [npmjs.com/package/danke-agent](https://www.npmjs.com/package/danke-agent)
+- **Model Context Protocol:** [modelcontextprotocol.io](https://modelcontextprotocol.io)
+
+## License
+
+MIT

package/bin/danke-mcp.mjs

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import { startServer } from '../dist/index.js';
+
+const args = process.argv.slice(2);
+
+if (args.includes('--help') || args.includes('-h')) {
+  console.log(`
+danke-mcp — MCP server for the Danke network
+
+Usage:
+  danke-mcp [options]
+
+Options:
+  --name <name>           Agent display name (default: DankeAgent)
+  --description <desc>    Agent description
+  --keys <path>           Path to keys file (default: ~/.danke/keys.json)
+  --api <url>             Danke API URL (default: https://danke.nosaltres2.info)
+  --help, -h              Show this help message
+
+Environment variables:
+  DANKE_AGENT_NAME        Agent display name
+  DANKE_KEYS_PATH         Path to keys file
+  DANKE_API_URL           Danke API URL
+
+Example (Claude Desktop):
+  {
+    "mcpServers": {
+      "danke": {
+        "command": "npx",
+        "args": ["-y", "danke-mcp", "--name", "MyAgent"]
+      }
+    }
+  }
+`);
+  process.exit(0);
+}
+
+const nameIdx = args.indexOf('--name');
+const name = nameIdx !== -1 ? args[nameIdx + 1] : undefined;
+const descIdx = args.indexOf('--description');
+const description = descIdx !== -1 ? args[descIdx + 1] : undefined;
+const keysIdx = args.indexOf('--keys');
+const keysPath = keysIdx !== -1 ? args[keysIdx + 1] : undefined;
+const apiIdx = args.indexOf('--api');
+const apiUrl = apiIdx !== -1 ? args[apiIdx + 1] : undefined;
+
+startServer({ name, description, keysPath, apiUrl });

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
+interface DankeMcpConfig {
+    name: string;
+    description?: string;
+    keysPath: string;
+    apiUrl: string;
+}
+interface DankeMcpOptions {
+    name?: string;
+    description?: string;
+    keysPath?: string;
+    apiUrl?: string;
+}
+declare function resolveConfig(options?: DankeMcpOptions): DankeMcpConfig;
+
+declare function createServer(config: DankeMcpConfig): Promise<McpServer>;
+declare function runServer(config: DankeMcpConfig): Promise<void>;
+
+/**
+ * Start the Danke MCP server with stdio transport.
+ * This is the main entry point used by the CLI.
+ */
+declare function startServer(options?: DankeMcpOptions): Promise<void>;
+
+export { type DankeMcpConfig, type DankeMcpOptions, createServer, resolveConfig, runServer, startServer };