agentwallet-mcp 1.0.0

package/build/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * AgentWallet MCP Server
+ *
+ * Gives AI agents access to AgentWallet infrastructure:
+ * create wallets, check balances, sign transactions,
+ * broadcast on any EVM chain, and track usage.
+ *
+ * All operations go through the AgentWallet WordPress REST API.
+ * Requires authentication via WordPress application password.
+ */
+export {};

package/build/index.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+/**
+ * AgentWallet MCP Server
+ *
+ * Gives AI agents access to AgentWallet infrastructure:
+ * create wallets, check balances, sign transactions,
+ * broadcast on any EVM chain, and track usage.
+ *
+ * All operations go through the AgentWallet WordPress REST API.
+ * Requires authentication via WordPress application password.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+// ─── Configuration ──────────────────────────────────────────────
+const API_BASE = process.env.AGENTWALLET_API_URL || 'https://hifriendbot.com/wp-json/agentwallet/v1';
+const API_USER = process.env.AGENTWALLET_USER || '';
+const API_PASS = process.env.AGENTWALLET_PASS || ''; // WordPress application password
+// ─── API Helper ─────────────────────────────────────────────────
+async function api(path, method = 'GET', body) {
+    const url = `${API_BASE}${path}`;
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    // Add basic auth if credentials provided
+    if (API_USER && API_PASS) {
+        headers['Authorization'] = 'Basic ' + Buffer.from(`${API_USER}:${API_PASS}`).toString('base64');
+    }
+    const options = { method, headers };
+    if (body && method !== 'GET') {
+        options.body = JSON.stringify(body);
+    }
+    const res = await fetch(url, options);
+    const data = await res.json();
+    if (!res.ok) {
+        const error = data.error || `HTTP ${res.status}`;
+        throw new Error(error);
+    }
+    return data;
+}
+function jsonResponse(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+// ─── Server ──────────────────────────────────────────────────────
+const server = new McpServer({
+    name: 'agentwallet',
+    version: '1.0.0',
+});
+// ─── Tool: create_wallet ─────────────────────────────────────────
+server.tool('create_wallet', 'Create a new EVM wallet. Returns the wallet ID and address. ' +
+    'Private key is encrypted server-side and never exposed.', {
+    label: z.string().default('').describe('Friendly name for the wallet'),
+    chain_id: z.number().int().default(1).describe('Default chain ID (1=Ethereum, 8453=Base, 137=Polygon, 56=BSC, 369=PulseChain)'),
+}, async ({ label, chain_id }) => {
+    const data = await api('/wallets', 'POST', { label, chain_id });
+    return jsonResponse(data);
+});
+// ─── Tool: list_wallets ──────────────────────────────────────────
+server.tool('list_wallets', 'List all wallets owned by the authenticated user. ' +
+    'Returns wallet IDs, addresses, labels, chain IDs, and status.', {}, async () => {
+    const data = await api('/wallets');
+    return jsonResponse(data);
+});
+// ─── Tool: get_wallet ────────────────────────────────────────────
+server.tool('get_wallet', 'Get details for a specific wallet by ID. ' +
+    'Returns address, label, chain, spending limits, and pause status.', {
+    wallet_id: z.number().int().describe('Wallet ID'),
+}, async ({ wallet_id }) => {
+    const data = await api(`/wallets/${wallet_id}`);
+    return jsonResponse(data);
+});
+// ─── Tool: get_balance ───────────────────────────────────────────
+server.tool('get_balance', 'Get the native token balance for a wallet on a specific chain. ' +
+    'Returns balance in both wei and human-readable format.', {
+    wallet_id: z.number().int().describe('Wallet ID'),
+    chain_id: z.number().int().optional().describe('Chain ID to check (defaults to wallet\'s default chain)'),
+}, async ({ wallet_id, chain_id }) => {
+    const params = chain_id ? `?chain_id=${chain_id}` : '';
+    const data = await api(`/wallets/${wallet_id}/balance${params}`);
+    return jsonResponse(data);
+});
+// ─── Tool: sign_transaction ──────────────────────────────────────
+server.tool('sign_transaction', 'Sign an EVM transaction with a wallet\'s private key. ' +
+    'Returns the signed raw transaction hex (ready for manual broadcast). ' +
+    'Does NOT broadcast — use send_transaction for sign + broadcast.', {
+    wallet_id: z.number().int().describe('Wallet ID'),
+    to: z.string().regex(/^0x[a-fA-F0-9]{40}$/).describe('Destination address'),
+    chain_id: z.number().int().optional().describe('Chain ID (defaults to wallet\'s default)'),
+    value: z.string().default('0').describe('Value in wei (decimal string)'),
+    data: z.string().default('').describe('Hex-encoded calldata (0x-prefixed) for contract calls'),
+    gas_limit: z.string().optional().describe('Gas limit (auto-estimated if omitted)'),
+    max_fee: z.string().optional().describe('Max fee per gas in wei (auto if omitted)'),
+    priority_fee: z.string().optional().describe('Max priority fee per gas in wei (auto if omitted)'),
+}, async ({ wallet_id, to, chain_id, value, data, gas_limit, max_fee, priority_fee }) => {
+    const body = { to, value, data };
+    if (chain_id)
+        body.chain_id = chain_id;
+    if (gas_limit)
+        body.gas_limit = gas_limit;
+    if (max_fee)
+        body.max_fee = max_fee;
+    if (priority_fee)
+        body.priority_fee = priority_fee;
+    const result = await api(`/wallets/${wallet_id}/sign`, 'POST', body);
+    return jsonResponse(result);
+});
+// ─── Tool: send_transaction ──────────────────────────────────────
+server.tool('send_transaction', 'Sign and broadcast an EVM transaction. ' +
+    'Returns the transaction hash on success. ' +
+    'The transaction is signed server-side and broadcast via RPC.', {
+    wallet_id: z.number().int().describe('Wallet ID'),
+    to: z.string().regex(/^0x[a-fA-F0-9]{40}$/).describe('Destination address'),
+    chain_id: z.number().int().optional().describe('Chain ID (defaults to wallet\'s default)'),
+    value: z.string().default('0').describe('Value in wei (decimal string)'),
+    data: z.string().default('').describe('Hex-encoded calldata (0x-prefixed) for contract calls'),
+    gas_limit: z.string().optional().describe('Gas limit (auto-estimated if omitted)'),
+    max_fee: z.string().optional().describe('Max fee per gas in wei (auto if omitted)'),
+    priority_fee: z.string().optional().describe('Max priority fee per gas in wei (auto if omitted)'),
+}, async ({ wallet_id, to, chain_id, value, data, gas_limit, max_fee, priority_fee }) => {
+    const body = { to, value, data };
+    if (chain_id)
+        body.chain_id = chain_id;
+    if (gas_limit)
+        body.gas_limit = gas_limit;
+    if (max_fee)
+        body.max_fee = max_fee;
+    if (priority_fee)
+        body.priority_fee = priority_fee;
+    const result = await api(`/wallets/${wallet_id}/send`, 'POST', body);
+    return jsonResponse(result);
+});
+// ─── Tool: get_usage ─────────────────────────────────────────────
+server.tool('get_usage', 'Get the current month\'s usage statistics. ' +
+    'Returns operations count, tier info, remaining quota, and fees.', {}, async () => {
+    const data = await api('/usage');
+    return jsonResponse(data);
+});
+// ─── Tool: pause_wallet ──────────────────────────────────────────
+server.tool('pause_wallet', 'Emergency pause a wallet. No transactions can be signed while paused.', {
+    wallet_id: z.number().int().describe('Wallet ID to pause'),
+}, async ({ wallet_id }) => {
+    const data = await api(`/wallets/${wallet_id}/pause`, 'POST');
+    return jsonResponse(data);
+});
+// ─── Tool: unpause_wallet ────────────────────────────────────────
+server.tool('unpause_wallet', 'Resume a paused wallet so transactions can be signed again.', {
+    wallet_id: z.number().int().describe('Wallet ID to unpause'),
+}, async ({ wallet_id }) => {
+    const data = await api(`/wallets/${wallet_id}/unpause`, 'POST');
+    return jsonResponse(data);
+});
+// ─── Tool: get_chains ────────────────────────────────────────────
+server.tool('get_chains', 'List all supported EVM chains with their chain IDs, native tokens, ' +
+    'stablecoins, and RPC configuration status.', {}, async () => {
+    const data = await api('/chains');
+    return jsonResponse(data);
+});
+// ─── Tool: delete_wallet ─────────────────────────────────────────
+server.tool('delete_wallet', 'Delete (soft-delete) a wallet. The wallet will no longer appear in listings ' +
+    'and cannot be used for transactions.', {
+    wallet_id: z.number().int().describe('Wallet ID to delete'),
+}, async ({ wallet_id }) => {
+    const data = await api(`/wallets/${wallet_id}`, 'DELETE');
+    return jsonResponse(data);
+});
+// ─── Start ──────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error('AgentWallet MCP server failed to start:', error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "agentwallet-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for AgentWallet — lets AI agents create wallets, sign transactions, and broadcast on any EVM chain",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "agentwallet-mcp": "build/index.js"
+  },
+  "files": [
+    "build",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "wallet",
+    "ai-agent",
+    "blockchain",
+    "evm",
+    "ethereum",
+    "base",
+    "polygon",
+    "bsc",
+    "pulsechain",
+    "transaction-signing",
+    "agentwallet"
+  ],
+  "author": "HiFriendbot (https://hifriendbot.com)",
+  "license": "MIT",
+  "homepage": "https://hifriendbot.com/agentwallet",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.4",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  }
+}