feat: add MCP server module to expose wallet tools to Claude/Cursor/OpenClaw

[up2itnow0822]

Summary

Add an MCP (Model Context Protocol) server module to agent-wallet-sdk that exposes wallet operations as MCP tools. This enables any MCP-compatible AI orchestrator (Claude Desktop, Cursor, OpenClaw, VS Code + Copilot) to interact with agent wallets natively.

Motivation

Competitive gap: OKX OnchainOS (identified in our competitive analysis) provides chain abstraction but has no MCP integration. Adding MCP server support to agent-wallet-sdk differentiates us as the only agent wallet with native MCP tooling.

Microsoft MCP C# SDK v1.0: Microsoft shipped the official MCP C# SDK v1.0 on March 5, 2026, extending MCP to the entire .NET/enterprise ecosystem. Enterprise adoption of MCP is accelerating. Our wallet needs to be accessible from any MCP client.

Proposed Implementation

New module: @agent-wallet-sdk/mcp-server

Tools to expose:

• createWallet - Create a new agent wallet with spend limits
• getBalance - Check wallet balance across chains
• sendPayment - Send USDC via x402 protocol
• getTransactionHistory - Retrieve audit trail
• setSpendLimit - Configure per-transaction and daily limits

Transport: stdio (for CLI integration) and HTTP/SSE (for web integration)

Dependencies:

• @modelcontextprotocol/sdk (official MCP TypeScript SDK)
• agent-wallet-sdk (this package)

Architecture

MCP Client (Claude/Cursor/OpenClaw)
  |
  v
agent-wallet-sdk-mcp (MCP Server)
  |
  v
agent-wallet-sdk (Wallet Operations)
  |
  v
x402 / Base / Etherlink (On-chain)

Acceptance Criteria

• MCP server starts via npx agent-wallet-sdk-mcp
• All 5 tools registered and callable from Claude Desktop
• stdio and HTTP/SSE transports supported
• README with setup instructions for Claude, Cursor, and OpenClaw
• Integration tests against local wallet instance

References

• Microsoft MCP C# SDK v1.0
• MCP TypeScript SDK
• OKX OnchainOS (competitive reference - no MCP support)