httpcat-cli 0.0.7 → 0.0.10

package/README.md

@@ -8,6 +8,7 @@ httpcat is a full-featured CLI tool that provides both interactive (with ASCII a
 
 - 🎨 **Interactive Shell** - Beautiful REPL with ASCII art cats and colored output
 - 🤖 **Headless Mode** - JSON output for scripting and LLM/agent integration
+- 🔌 **MCP Server** - Built-in Model Context Protocol server for AI assistant integration
 - 💳 **x402 Payments** - Automatic payment handling via x402 protocol
 - 🔐 **Secure Config** - Local configuration storage in `~/.config/httpcat`
 - 🌐 **Multi-Network** - Support for Base Sepolia (testnet) and Base (mainnet)
@@ -73,20 +74,21 @@ $ httpcat
   > ^ <  Your agent for token operations
 
 🔗 Connected to: base-sepolia
-🌐 Agent: https://agent.httpcat.fun
+🌐 Agent: https://agent.402.cat
 
 httpcat> help
 Available Commands:
 
   create <name> <symbol>          Create a new token
-  buy <tokenId> <amount>          Buy tokens ($0.05, $0.10, or $0.20)
-  sell <tokenId> <amount|all>     Sell tokens
-  info <tokenId>                  Get token information
+  buy <id|name|symbol> <amount>   Buy tokens ($0.05, $0.10, or $0.20)
+  sell <id|name|symbol> <amount|all>  Sell tokens
+  info <id|name|symbol>           Get token information
   list [--sort mcap|created]      List all tokens
+  chat [token]                    Start streaming chat (optional: token symbol/name/address)
   balance                         Check wallet balance (ETH and USDC)
   health                          Check agent health
   config [--show|--set|--reset]   Manage configuration
-  network <name>                  Switch network
+  network                          Show current network
   help                            Show this help message
   exit                            Exit the shell
 
@@ -321,6 +323,37 @@ httpcat health
 
 **Cost:** $0.0001 USDC (or 402 response)
 
+### Chat
+
+Start streaming chat with the httpcat community. Join general chat or token-specific discussions.
+
+**Interactive:**
+
+```bash
+httpcat> chat                    # Join general chat
+httpcat> chat MTK                # Join chat for token with symbol "MTK"
+httpcat> chat "My Token"         # Join chat for token with name "My Token"
+httpcat> chat 0x1234...          # Join chat for token at address
+```
+
+**CLI:**
+
+```bash
+httpcat chat
+httpcat chat MTK
+httpcat chat "My Token"
+httpcat chat 0x1234...
+httpcat --json chat MTK
+```
+
+**Token Identifier:**
+
+- Token symbol: `MTK` (case-insensitive)
+- Token name: `"My Token"` (use quotes if it contains spaces)
+- Token address: `0x1234...`
+
+**Cost:** $0.01 USDC to join, $0.0001 USDC per message, 10 minute lease
+
 ### Configuration
 
 Manage your httpcat configuration.
@@ -341,6 +374,40 @@ httpcat config --show             # Show current config (JSON)
 httpcat config --set network=base # Update a setting
 ```
 
+### MCP Server
+
+Start the Model Context Protocol server for AI assistant integration.
+
+**CLI:**
+
+```bash
+httpcat mcp-server
+```
+
+**Description:**
+
+Starts an MCP server that exposes all httpcat CLI commands as MCP tools. The server communicates via stdio and can be used with MCP clients like Cursor or Claude Desktop.
+
+**Configuration:**
+
+Add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "httpcat": {
+      "command": "npx",
+      "args": ["-y", "httpcat-cli", "mcp-server"],
+      "env": {
+        "HTTPCAT_PRIVATE_KEY": "0x..." // Optional
+      }
+    }
+  }
+}
+```
+
+See the [MCP Server section](#mcp-server-model-context-protocol) for detailed documentation.
+
 ## Headless Mode (JSON Output)
 
 Perfect for scripting, automation, or LLM/agent integration.
@@ -508,7 +575,7 @@ All commands with `--json` flag return structured JSON responses. The output fol
 {
   "status": "ok",
   "timestamp": "2025-11-22T10:30:00.000Z",
-  "agent": "https://agent.httpcat.fun"
+  "agent": "https://agent.402.cat"
 }
 ```
 
@@ -529,7 +596,7 @@ All commands with `--json` flag return structured JSON responses. The output fol
 ```json
 {
   "name": "httpcat-cli",
-  "version": "0.1.0"
+  "version": "0.0.8"
 }
 ```
 
@@ -576,6 +643,231 @@ if (( $(echo "$PNL > 0" | bc -l) )); then
 fi
 ```
 
+## MCP Server (Model Context Protocol)
+
+httpcat includes a built-in MCP server that exposes all CLI commands as MCP tools, enabling seamless integration with AI assistants like Claude (via Claude Desktop) or Cursor.
+
+### Quick Start
+
+**Start the MCP server:**
+
+```bash
+httpcat mcp-server
+```
+
+**Or use npx (no installation needed):**
+
+```bash
+npx httpcat-cli mcp-server
+```
+
+### MCP Client Configuration
+
+Add the httpcat MCP server to your MCP client configuration:
+
+#### For Cursor
+
+Add to your Cursor settings (`.cursor/mcp.json` or settings UI):
+
+```json
+{
+  "mcpServers": {
+    "httpcat": {
+      "command": "npx",
+      "args": ["-y", "httpcat-cli", "mcp-server"],
+      "env": {
+        "HTTPCAT_PRIVATE_KEY": "0x..." // Optional - can also pass via tool params
+      }
+    }
+  }
+}
+```
+
+#### For Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "httpcat": {
+      "command": "npx",
+      "args": ["-y", "httpcat-cli", "mcp-server"],
+      "env": {
+        "HTTPCAT_PRIVATE_KEY": "0x..."
+      }
+    }
+  }
+}
+```
+
+#### Using Global Install
+
+If you've installed httpcat globally:
+
+```json
+{
+  "mcpServers": {
+    "httpcat": {
+      "command": "httpcat",
+      "args": ["mcp-server"],
+      "env": {
+        "HTTPCAT_PRIVATE_KEY": "0x..."
+      }
+    }
+  }
+}
+```
+
+### Available MCP Tools
+
+The MCP server exposes the following tools:
+
+#### `create_token`
+
+Create a new token on the bonding curve.
+
+**Parameters:**
+
+- `name` (string, required) - Token name (e.g., "My Token")
+- `symbol` (string, required) - Token symbol/ticker (3-10 characters)
+- `photoUrl` (string, optional) - Photo URL for token logo
+- `bannerUrl` (string, optional) - Banner image URL
+- `websiteUrl` (string, optional) - Website URL
+- `privateKey` (string, optional) - Private key (overrides config/env)
+
+**Cost:** $0.01 USDC
+
+#### `buy_token`
+
+Buy tokens from the bonding curve.
+
+**Parameters:**
+
+- `identifier` (string, required) - Token ID (UUID), name, or symbol
+- `amount` (string, required) - Amount: "0.05", "0.10", or "0.20" (testnet) | "50", "100", or "200" (mainnet)
+- `privateKey` (string, optional) - Private key (overrides config/env)
+
+**Cost:** Amount + 1% fee
+
+#### `sell_token`
+
+Sell tokens back to the bonding curve.
+
+**Parameters:**
+
+- `identifier` (string, required) - Token ID (UUID), name, or symbol
+- `amount` (string, required) - Amount: number (e.g., "1000"), percentage (e.g., "50%"), or "all"
+- `privateKey` (string, optional) - Private key (overrides config/env)
+
+**Cost:** 1% fee deducted from proceeds
+
+#### `token_info`
+
+Get detailed information about a token.
+
+**Parameters:**
+
+- `identifier` (string, required) - Token ID (UUID), name, or symbol
+- `privateKey` (string, optional) - Private key (overrides config/env)
+
+**Returns:** Token details, price, market cap, graduation progress, and your position (if you own tokens)
+
+**Cost:** $0.0001 USDC
+
+#### `list_tokens`
+
+List all tokens with pagination and sorting.
+
+**Parameters:**
+
+- `page` (number, optional) - Page number (default: 1)
+- `limit` (number, optional) - Items per page (default: 20, max: 100)
+- `sort` (string, optional) - Sort by: "mcap", "created", or "name" (default: "mcap")
+- `privateKey` (string, optional) - Private key (overrides config/env)
+
+**Cost:** $0.0001 USDC
+
+#### `check_balance`
+
+Check wallet balance (ETH and USDC).
+
+**Parameters:**
+
+- `privateKey` (string, optional) - Private key (overrides config/env)
+
+**Cost:** Free (no payment required)
+
+#### `health_check`
+
+Check if the httpcat agent is running and healthy.
+
+**Parameters:**
+
+- `privateKey` (string, optional) - Private key (overrides config/env)
+
+**Cost:** $0.0001 USDC
+
+### Private Key Configuration
+
+Private keys can be configured in three ways (priority order):
+
+1. **Tool parameter** - Pass `privateKey` in each tool call (highest priority)
+2. **Environment variable** - Set `HTTPCAT_PRIVATE_KEY` in the MCP client config
+3. **Config file** - Use `httpcat config` to set up `~/.config/httpcat/config.json`
+
+**Security Recommendation:** Use the environment variable in your MCP client config rather than passing it in each tool call.
+
+### Example MCP Tool Usage
+
+Once configured, AI assistants can use the tools like this:
+
+```
+create_token(name="Moon Token", symbol="MOON", websiteUrl="https://moon.com")
+buy_token(identifier="abc123-...", amount="0.20")
+token_info(identifier="MOON")
+list_tokens(sort="mcap", limit=10)
+check_balance()
+```
+
+### Response Format
+
+All MCP tools return structured JSON responses matching the CLI's JSON output format:
+
+**Success:**
+
+```json
+{
+  "success": true,
+  "operation": "tool_name",
+  "data": {
+    // Tool-specific data
+  }
+}
+```
+
+**Error:**
+
+```json
+{
+  "success": false,
+  "operation": "tool_name",
+  "error": {
+    "message": "Error message",
+    "code": 1,
+    "details": {}
+  }
+}
+```
+
+### Benefits
+
+- **No Shell Access Required** - AI assistants can interact with httpcat without needing shell/terminal access
+- **Structured Responses** - Consistent JSON output format for reliable parsing
+- **Secure** - Private keys can be managed via environment variables or config
+- **Always Up-to-Date** - Using `npx` ensures you always get the latest version
+- **Zero Configuration** - Works out of the box with standard MCP clients
+
 ## Advanced Usage
 
 ### Environment Management
@@ -619,7 +911,7 @@ httpcat env use production
 #### Predefined Environments
 
 - **local** - `http://localhost:8787` (base-sepolia)
-- **sepolia** - `https://agent.httpcat.fun` (base-sepolia)
+- **sepolia** - `https://agent.402.cat` (base-sepolia)
 
 #### Environment Priority
 
@@ -686,7 +978,7 @@ Config is stored at `~/.config/httpcat/config.json`:
 {
   "privateKey": "0x...",
   "network": "base-sepolia",
-  "agentUrl": "https://agent.httpcat.fun",
+  "agentUrl": "https://agent.402.cat",
   "facilitatorUrl": "https://facilitators.x402scan.com",
   "defaultMaxPayment": "10.00",
   "preferences": {
@@ -859,5 +1151,5 @@ MIT
 ## Support
 
 - Report issues: https://github.com/hathbanger/httpcat-cli/issues
-- httpcat agent: https://agent.httpcat.fun
+- httpcat agent: https://agent.402.cat
 - x402 protocol: https://x402.org

package/chat-automation.js

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+
+/**
+ * Automated chat script for httpcat chat --json mode
+ * 
+ * Usage:
+ *   node chat-automation.js <token> [message1] [message2] ...
+ * 
+ * Or pipe messages:
+ *   echo -e "Hello\nWorld" | node chat-automation.js <token>
+ */
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const token = process.argv[2];
+
+if (!token) {
+  console.error('Usage: node chat-automation.js <token> [message1] [message2] ...');
+  console.error('   Or: echo -e "msg1\\nmsg2" | node chat-automation.js <token>');
+  process.exit(1);
+}
+
+// Get messages from command line args or stdin
+const messages = process.argv.slice(3);
+
+// Spawn httpcat chat process
+const chatProcess = spawn('httpcat', ['chat', '--json', token], {
+  stdio: ['pipe', 'pipe', 'inherit'], // Capture stdout to parse JSON
+  shell: true,
+});
+
+// Handle JSON output from chat
+let outputBuffer = '';
+chatProcess.stdout.on('data', (data) => {
+  outputBuffer += data.toString();
+  const lines = outputBuffer.split('\n');
+  outputBuffer = lines.pop() || ''; // Keep incomplete line
+  
+  for (const line of lines) {
+    if (!line.trim()) continue;
+    
+    try {
+      const event = JSON.parse(line);
+      
+      switch (event.type) {
+        case 'joined':
+          console.error(`✅ Joined chat. Lease ID: ${event.leaseId}`);
+          // Send initial messages if provided
+          if (messages.length > 0) {
+            setTimeout(() => {
+              messages.forEach((msg, index) => {
+                setTimeout(() => {
+                  if (chatProcess.stdin && !chatProcess.stdin.destroyed) {
+                    chatProcess.stdin.write(msg + '\n');
+                  }
+                }, index * 1000); // 1 second between messages
+              });
+            }, 2000); // Wait 2 seconds after joining
+          }
+          break;
+          
+        case 'message':
+          const msg = event.data;
+          const author = msg.authorShort || msg.author?.slice(0, 6);
+          const time = new Date(msg.timestamp).toLocaleTimeString();
+          console.error(`[${time}] ${author}: ${msg.message}`);
+          
+          // Auto-respond to messages containing "claude" (case-insensitive)
+          // Check if message is from someone else (not our own)
+          const isOwn = msg.author?.toLowerCase() === process.env.HTTPCAT_ADDRESS?.toLowerCase();
+          if (msg.message.toLowerCase().includes('claude') && !isOwn) {
+            setTimeout(() => {
+              const response = `Hello! I'm Claude, an AI assistant. How can I help you?`;
+              if (chatProcess.stdin && !chatProcess.stdin.destroyed) {
+                chatProcess.stdin.write(response + '\n');
+              }
+            }, 1000);
+          }
+          break;
+          
+        case 'message_sent':
+          console.error(`✅ Message sent: ${event.messageId}`);
+          break;
+          
+        case 'lease_expired':
+          console.error('⏱️  Lease expired. Sending /renew...');
+          if (chatProcess.stdin && !chatProcess.stdin.destroyed) {
+            chatProcess.stdin.write('/renew\n');
+          }
+          break;
+          
+        case 'error':
+          console.error(`❌ Error: ${event.error}`);
+          break;
+          
+        case 'exiting':
+          console.error('👋 Chat session ended');
+          process.exit(0);
+          break;
+      }
+    } catch (error) {
+      // Not JSON, might be regular output - ignore or log
+      if (line.trim() && !line.startsWith('{')) {
+        console.error(line);
+      }
+    }
+  }
+});
+
+// Send messages from stdin if no command line args
+if (messages.length === 0 && !process.stdin.isTTY) {
+  let stdinBuffer = '';
+  
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('data', (chunk) => {
+    stdinBuffer += chunk.toString();
+    const lines = stdinBuffer.split('\n');
+    stdinBuffer = lines.pop() || '';
+    
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (trimmed) {
+        // Wait a bit for chat to be ready, then send
+        setTimeout(() => {
+          if (chatProcess.stdin && !chatProcess.stdin.destroyed) {
+            chatProcess.stdin.write(trimmed + '\n');
+          }
+        }, 2000);
+      }
+    }
+  });
+  
+  process.stdin.on('end', () => {
+    // Keep process alive to receive messages
+    // User can Ctrl+C to exit
+  });
+} else if (messages.length > 0) {
+  // Messages provided via command line - will be sent after joining
+  // (handled in the 'joined' event handler above)
+}
+
+// Handle process errors
+chatProcess.on('error', (error) => {
+  console.error(`❌ Failed to start chat process: ${error.message}`);
+  process.exit(1);
+});
+
+chatProcess.on('exit', (code) => {
+  if (code !== 0 && code !== null) {
+    console.error(`Chat process exited with code ${code}`);
+  }
+  process.exit(code || 0);
+});
+
+// Handle Ctrl+C
+process.on('SIGINT', () => {
+  console.error('\n👋 Shutting down...');
+  if (chatProcess.stdin && !chatProcess.stdin.destroyed) {
+    chatProcess.stdin.write('/exit\n');
+  }
+  setTimeout(() => {
+    chatProcess.kill();
+    process.exit(0);
+  }, 1000);
+});
+

package/dist/commands/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAW7C,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,GAAG,eAAe,GAAG,OAAO,CAAC;IAC5C,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAuDD,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,aAAa,EACrB,eAAe,CAAC,EAAE,MAAM,EACxB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,cAAc,CAAC,CA+BzB;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,CAa5B;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC,CAS/B;AAgND,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,QAAQ,GAAE,OAAe,EACzB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CA+zDf;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAQjE"}