@newblock/iautopay-mcp 0.0.1 → 0.0.3

package/CLAUDE_CLI_MCP_SETUP.md

@@ -0,0 +1,138 @@
+# Claude CLI MCP Configuration
+
+This project supports both OpenCode and Claude CLI MCP servers.
+
+## OpenCode
+
+Configuration is automatically generated at installation via `opencode.json`.
+
+Available commands:
+- `/autopay_toA` - Quick payment of 0.01 USDC
+- `/autopay_toB` - Quick payment of 0.05 USDC (with confirmation)
+- `/autopay_buy_glm_nvidia_apikey` - Purchase GLM NVIDIA API Key
+- `/autopay_custom` - Custom payment
+- `/autopay_getInfo` - Get service information
+
+## Claude CLI
+
+### Option 1: Use Pre-generated Config File (Recommended)
+
+```bash
+# Use the auto-generated mcp-config.json
+claude --mcp-config mcp-config.json
+```
+
+This method uses the configuration file generated at `mcp-config.json` during installation.
+
+### Option 2: Add to Local Config
+
+```bash
+# Add MCP server to Claude CLI
+BUYER_PRIVATE_KEY="your_private_key" claude mcp add iauto-pay \
+  -e BUYER_PRIVATE_KEY="your_private_key" \
+  -- npx -y @newblock/iautopay-mcp
+
+# Verify connection:
+claude mcp list
+
+# Should show:
+# iauto-pay: npx -y @newblock/iautopay-mcp - ✓ Connected
+```
+
+After adding, you can simply run `claude` without any additional flags.
+
+### Option 3: Manual Setup
+
+```bash
+# Create mcp-config.json manually:
+{
+  "mcpServers": {
+    "iauto-pay": {
+      "command": "npx",
+      "args": ["-y", "@newblock/iautopay-mcp"],
+      "env": {
+        "BUYER_PRIVATE_KEY": "your_private_key_here"
+      }
+    }
+  }
+}
+
+# Then use it:
+claude --mcp-config mcp-config.json
+```
+
+## Available Tools
+
+When using Claude CLI with MCP enabled, the following tools are available:
+
+- `pay_stablecoin` - Pay USDC to any address (auto-detects mainnet/testnet based on CUR_ENV)
+- `buy_glm_nvidia_apikey` - Purchase GLM NVIDIA API Key
+- `get_info` - Get server information (stock, price, network config)
+- `pay_preset` - Quick preset payments (toA: 0.01 USDC, toB: 0.05 USDC)
+
+## Usage Examples
+
+### Using Config File
+```bash
+# Start Claude CLI with MCP support
+claude --mcp-config mcp-config.json
+```
+
+### Using Local Config
+```bash
+# Start Claude CLI (MCP servers from local config are auto-loaded)
+claude
+```
+
+## Verification
+
+```bash
+# List configured MCP servers
+claude mcp list
+
+# Get details of specific server
+claude mcp get iauto-pay
+```
+
+## Removing MCP Server
+
+If you added to local config:
+```bash
+claude mcp remove iauto-pay -s local
+```
+
+If using config file, simply remove the `--mcp-config mcp-config.json` flag when running `claude`.
+
+## Troubleshooting
+
+**MCP server not connecting:**
+1. Ensure dependencies are installed: `npm install -g @newblock/iautopay-mcp`
+2. Verify npx can run the package: `npx @newblock/iautopay-mcp`
+3. Check environment variable is set correctly in `mcp-config.json` or local config
+
+**Tools not showing up:**
+1. Verify MCP connection: `claude mcp list`
+2. Check server health: `claude mcp get iauto-pay`
+3. Restart Claude CLI
+
+**Wrong environment (dev vs prod):**
+- The published npm package uses dev environment by default
+- For production environment, you may need to build from source or request a prod release
+
+## Configuration Files
+
+- `opencode.json` - OpenCode configuration (auto-generated)
+- `mcp-config.json` - Claude CLI MCP configuration (auto-generated)
+- `mcp-config.json.example` - Example MCP config template
+- `scripts/generate-opencode-config.js` - Configuration generation script
+- `~/.claude.json` (project-scoped) or `~/.claude/mcp.json` (global) - Claude CLI local config
+
+## Environment Variables
+
+Set `BUYER_PRIVATE_KEY` when running the configuration script:
+
+```bash
+BUYER_PRIVATE_KEY="your_private_key" npm run install:opencode-config
+```
+
+This ensures both OpenCode and Claude CLI configurations have the correct key.

package/LICENSE

@@ -1,21 +1,19 @@
-MIT License
-
-Copyright (c) 2026 NewBlock
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0)
+
+Copyright (c) 2026 Michael
+
+You are free to:
+
+Share — copy and redistribute the material in any medium or format
+Adapt — remix, transform, and build upon the material
+
+Under the following terms:
+
+Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
+
+NonCommercial — You may not use the material for commercial purposes.
+
+No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.
+
+To view a copy of this license, visit:
+https://creativecommons.org/licenses/by-nc/4.0/

package/README.md

@@ -1,6 +1,6 @@
-# iautopay-mcp
+# iAutoPay MCP Service
 
-iAutoPay is an MCP service that enables AI agents to automatically pay for purchases. It currently runs on the Base chain (operated by Coinbase) and supports USDC payments. It can be used by intelligent agents to automatically purchase paid AI-related services and data.
+An MCP (Model Context Protocol) service that enables AI agents to automatically pay for purchases. It currently runs on Base chain (operated by Coinbase) and supports USDC payments. It can be used by intelligent agents to automatically purchase paid AI-related services and data.
 
 ## Features
 
@@ -9,26 +9,27 @@ iAutoPay is an MCP service that enables AI agents to automatically pay for purch
 - 🔐 **Secure**: Environment variable based configuration for private keys
 - 🤖 **AI-Native**: Full MCP integration designed for AI agents
 - 💸 **Fixed Transfer**: Preset fixed transfer account command, direct transfer by command
-- 🔑 **API Key Purchase**: Support GLM4.7 LLM APIKEY purchase service
+- 🔑 **API Key Purchase**: Support GLM4.7 LLM API Key purchase service with dynamic pricing
 
-## Quick Start with npx (Recommended)
+## Supported Models
 
-No installation required! Just run:
-
-```bash
-npx @newblock/iautopay-mcp
-```
-
-This will automatically download and cache the package.
+API keys purchased through this service provide access to:
+- `z-ai/glm4.7` (GLM4.7 with thinking chain support)
+- `minimaxai/minimax-m2.1` (MiniMax general LLM)
+- `deepseek-ai/deepseek-v3.2` (DeepSeek with thinking chain)
 
 ## Installation
 
 ### Option 1: npx (Recommended)
 
+No installation required! Just run:
+
 ```bash
 npx @newblock/iautopay-mcp
 ```
 
+This will automatically download and cache the package.
+
 ### Option 2: Global Install
 
 ```bash
@@ -74,6 +75,22 @@ Add to your `opencode.json`:
 }
 ```
 
+### Claude CLI Configuration
+
+For detailed instructions on using Claude CLI with MCP, see [CLAUDE_CLI_MCP_SETUP.md](CLAUDE_CLI_MCP_SETUP.md).
+
+#### Quick Setup
+
+```bash
+# Install and add to Claude CLI
+BUYER_PRIVATE_KEY="your_private_key" claude mcp add iauto-pay \
+  -e BUYER_PRIVATE_KEY="your_private_key" \
+  -- npx -y @newblock/iautopay-mcp
+
+# Use with MCP config
+claude --mcp-config mcp-config.json
+```
+
 ### Claude Code Configuration
 
 Add to your `~/.claude/claude_desktop_config.json`:
@@ -94,32 +111,102 @@ Add to your `~/.claude/claude_desktop_config.json`:
 
 ## MCP Tools
 
-### pay_stablecoin
+### guide
+
+⭐ **FIRST TIME?** Run this guide to learn how to use iAutoPay tools and commands.
+
+**Parameters:**
+```json
+{}
+```
+
+**Returns:**
+- Complete guide with all tools and commands
+- Pricing information
+- Network configuration
 
-Direct stablecoin payment using EIP-3009 transferWithAuthorization.
+### info
+
+Get iAutoPay server information (API key stock, price, network config).
 
 **Parameters:**
 ```json
+{}
+```
+
+**Returns:**
+```json
 {
-  "to": "0x1234567890123456789012345678901234567890",
-  "amount": "1000000"
+  "stock": 100,
+  "prices": {
+    "1day": "0.09 USDC",
+    "7days": "0.49 USDC",
+    "30days": "0.99 USDC"
+  },
+  "network": {
+    "chainId": 84532,
+    "rpcUrl": "https://sepolia.base.org"
+  }
 }
 ```
 
-**Usage example:**
+### buy_apikey
+
+Purchase an API key with optional duration (1/7/30 days).
+
+**Parameters:**
+```json
+{
+  "duration": 1
+}
 ```
-Use iauto-pay_pay_stablecoin tool to send 1 USDC to 0x123...
+
+**Duration Options:**
+- `1`: 1 day validity
+- `7`: 7 days validity
+- `30`: 30 days validity
+
+**Returns:**
+```json
+{
+  "apiKey": "sk-ABCD12345678901234567890",
+  "txHash": "0x4d757c7e121ad31607ee1e9c5af65bfe13b82c112fcf077638814c031ecc3a6b",
+  "payState": "paid",
+  "price": "0.09 USDC",
+  "deductedAmount": "0.09 USDC",
+  "currentBalance": "9.91 USDC"
+}
 ```
 
-**Tip**: You can preset frequently used transfer addresses and amounts to avoid manual input each time, improving convenience.
+### pay_stablecoin
+
+Pay stablecoin to any address using EIP-3009.
+
+**Parameters:**
+```json
+{
+  "to": "0x1234567890123456789012345678901234567890",
+  "amount": "100000"
+}
+```
 
-### buy_glm_apikey
+**Amount is in smallest units** (e.g., 100000 = 0.1 USDC, 1000000 = 1 USDC)
 
-**Tip**: You can preset frequently used transfer addresses and amounts to avoid manual input each time, improving convenience.
+**Returns:**
+```json
+{
+  "from": "0x...",
+  "to": "0x...",
+  "amount": "0.1 USDC",
+  "txHash": "0x...",
+  "deductedAmount": "0.1 USDC",
+  "currentBalance": "9.9 USDC"
+}
+```
 
-### buy_glm_apikey
+### sync_opencode_config
 
-Purchase GLM4.7 LLM APIKEY.
+Auto-configure opencode.json with quick commands (autopay_toA, autopay_toB, etc.).
 
 **Parameters:**
 ```json
@@ -129,10 +216,14 @@ Purchase GLM4.7 LLM APIKEY.
 **Returns:**
 ```json
 {
-  "apiKey": "sk-ABCD12345678901234567890",
-  "txHash": "0x4d757c7e121ad31607ee1e9c5af65bfe13b82c112fcf077638814c031ecc3a6b",
-  "payState": "paid"
+  "message": "✅ 已添加 7 个命令到 opencode.json"
 }
+```
+
+### refresh_pricing
+
+Refresh pricing from API. Use this if prices are changed on the server.
+
 **Parameters:**
 ```json
 {}
@@ -141,9 +232,9 @@ Purchase GLM4.7 LLM APIKEY.
 **Returns:**
 ```json
 {
-  "apiKey": "sk-RxmFQ2cLfBaefDFfkYlEGY51E74pl5h06bAHbF41vyCCCC",
-  "txHash": "0x4d757c7e121ad31607ee1e9c5af65bfe13b82c112fcf077638814c031ecc3a6b",
-  "payState": "paid"
+  "1day": "0.09 USDC",
+  "7days": "0.49 USDC",
+  "30days": "0.99 USDC"
 }
 ```
 
@@ -151,65 +242,39 @@ Purchase GLM4.7 LLM APIKEY.
 
 The MCP server supports two environments configured in `src/server.ts`:
 
-### Production (Base Mainnet)
-- Chain ID: 8453
-- RPC URL: https://mainnet.base.org
-- USDC Address: 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
-- Token Name: "USD Coin"
-
 ### Development (Base Sepolia)
 - Chain ID: 84532
 - RPC URL: https://sepolia.base.org
 - USDC Address: 0x036CbD53842c5426634e7929541eC2318f3dCF7e
 - Token Name: "USDC"
 
-To switch environments, modify `CUR_ENV` in `src/server.ts` and rebuild:
-
-```bash
-# Edit src/server.ts: const CUR_ENV: 'dev' | 'prod' = 'prod';
-npm run build
-npm publish
-```
+### Production (Base Mainnet)
+- Chain ID: 8453
+- RPC URL: https://mainnet.base.org
+- USDC Address: 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
+- Token Name: "USD Coin"
 
 ## Example Workflows
 
 ### Example 1: Purchase GLM4.7 API Key
 
 ```
-Use iauto-pay_buy_glm_apikey tool to purchase GLM4.7 LLM API Key
+Use info tool to check stock and pricing
+Use buy_apikey tool with duration: 1
+Receive API key in response
 ```
 
 ### Example 2: Direct USDC Payment
 
 ```
-Use iauto-pay_pay_stablecoin tool to send 0.01 USDC to 0x1a85156c2943b63febeee7883bd84a7d1cf0da0c
+Use pay_stablecoin tool with to: "0x1a85156c2943b63febeee7883bd84a7d1cf0da0c" and amount: "10000"
+Transaction executes automatically
+Receive transaction hash
 ```
-Use the iauto-pay_buy_apikey tool to purchase an API key
-```
-
-### Example 2: Send Payment
-
-```
-Use the iauto-pay_pay_stablecoin tool to send 0.01 USDC to 0x1a85156c2943b63febeee7883bd84a7d1cf0da0c
-```
-
-## Requirements
-
-- Node.js >= 18.0.0
-- npm >= 9.0.0
-
-## Dependencies
-
-- @modelcontextprotocol/sdk ^1.0.0
-- @x402/core ^2.3.0
-- @x402/evm ^2.3.0
-- viem ^2.21.35
-- zod ^3.24.1
-- zod-to-json-schema ^3.24.1
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) file for details.
+Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0) - see [LICENSE](LICENSE) file for details.
 
 ## Repository
 
@@ -218,3 +283,8 @@ MIT License - see [LICENSE](LICENSE) file for details.
 ## Support
 
 For issues and questions, please use the [GitHub Issues](https://github.com/newblock/iautopay/issues).
+
+## Documentation
+
+- [CLAUDE_CLI_MCP_SETUP.md](CLAUDE_CLI_MCP_SETUP.md) - Claude CLI integration guide
+- [mcp-config.json.example](mcp-config.json.example) - MCP configuration template

package/bin/iautopay-mcp.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+
+import('../dist/iautopay-mcp.js').catch((err) => {
+  console.error('Failed to load iautopay-mcp:', err);
+  process.exit(1);
+});

package/dist/check_balance.js

@@ -0,0 +1,114 @@
+import { createPublicClient, http, formatUnits } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { baseSepolia, base } from "viem/chains";
+// Hardcoded configuration
+const CUR_ENV = 'prod';
+const BUYER_PRIVATE_KEY = process.env.BUYER_PRIVATE_KEY;
+if (!BUYER_PRIVATE_KEY) {
+    console.error("Please provide BUYER_PRIVATE_KEY env var via opencode.json");
+    process.exit(1);
+}
+const account = privateKeyToAccount(BUYER_PRIVATE_KEY);
+console.log("付款地址 (Address):", account.address);
+const chain = CUR_ENV === 'dev' ? baseSepolia : base;
+const client = createPublicClient({
+    chain,
+    transport: http(),
+});
+console.log(`当前环境: ${CUR_ENV.toUpperCase()}`);
+console.log(`区块链: ${chain.name} (chain ID: ${chain.id})`);
+console.log("----------------------------------------");
+// USDC addresses
+const USDC_ADDRESSES = {
+    sepolia: {
+        official: "0x4200000000000000000000000000000000000006",
+        custom: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    },
+    mainnet: {
+        official: "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
+    }
+};
+const currentUSDC = CUR_ENV === 'dev' ? USDC_ADDRESSES.sepolia : USDC_ADDRESSES.mainnet;
+const usdcAbi = [
+    {
+        name: "balanceOf",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "account", type: "address" }],
+        outputs: [{ name: "", type: "uint256" }],
+    },
+    {
+        name: "decimals",
+        type: "function",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [{ name: "", type: "uint8" }],
+    },
+    {
+        name: "name",
+        type: "function",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [{ name: "", type: "string" }],
+    },
+    {
+        name: "version",
+        type: "function",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [{ name: "", type: "string" }],
+    }
+];
+async function checkToken(address, label) {
+    try {
+        const decimals = await client.readContract({
+            address: address,
+            abi: usdcAbi,
+            functionName: "decimals",
+        });
+        const balance = await client.readContract({
+            address: address,
+            abi: usdcAbi,
+            functionName: "balanceOf",
+            args: [account.address],
+        });
+        let tokenName = "Unknown";
+        try {
+            tokenName = await client.readContract({
+                address: address,
+                abi: usdcAbi,
+                functionName: "name",
+            });
+        }
+        catch { }
+        let tokenVersion = "Unknown";
+        try {
+            tokenVersion = await client.readContract({
+                address: address,
+                abi: usdcAbi,
+                functionName: "version",
+            });
+        }
+        catch { }
+        console.log(`[${label}] ${tokenName} (v${tokenVersion}) - ${address}`);
+        console.log(`  余额: ${formatUnits(balance, decimals)}`);
+        console.log(`  原始: ${balance.toString()}`);
+    }
+    catch (e) {
+        console.error(`[${label}] 查询失败:`, e?.message || e);
+    }
+}
+async function main() {
+    const ethBalance = await client.getBalance({ address: account.address });
+    console.log("付款地址:", account.address);
+    console.log("ETH 余额:", formatUnits(ethBalance, 18), "ETH");
+    console.log("----------------------------------------");
+    if ('official' in currentUSDC) {
+        await checkToken(currentUSDC.official, "Official USDC");
+        console.log("----------------------------------------");
+    }
+    if ('custom' in currentUSDC) {
+        await checkToken(currentUSDC.custom, "Custom USDC");
+    }
+}
+main();