{"_id":"@agent-economy-wallet/mcp-server","_rev":"2-60b7a0b30c22219c50970596fa18dfb0","name":"@agent-economy-wallet/mcp-server","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@agent-economy-wallet/mcp-server","version":"1.0.0","_id":"@agent-economy-wallet/mcp-server@1.0.0","maintainers":[{"name":"xavierscript","email":"david111francisco@gmail.com"}],"bin":{"agent-economy-wallet-mcp":"dist/index.js"},"dist":{"shasum":"f22ab4e6210dd0882e09ce42d8de72f74a3af8df","tarball":"https://registry.npmjs.org/@agent-economy-wallet/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":233,"integrity":"sha512-6ceXS3uo8a43eWUC8raflU2R7E854o4wG2ISdQzNNpFK4IB/h0hMugZ8swjU1/Lo1ct26cNID/wyYhxpAYZv4A==","signatures":[{"sig":"MEUCIGs2dudrvcS1FRM7U7EaRmstTXOvcMLwlci8TC2vH0GLAiEAlkKJA0Rb+YVNi4GIJGq/pIzAIEVXrKpwGFt2n7cXxUQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":368238},"main":"./dist/index.js","type":"module","_from":"file:agent-economy-wallet-mcp-server-1.0.0.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./api/server":{"types":"./dist/api/server.d.ts","import":"./dist/api/server.js"}},"scripts":{"dev":"tsc --watch","build":"tsc","clean":"rimraf dist","start":"node dist/index.js"},"_npmUser":{"name":"xavierscript","email":"david111francisco@gmail.com"},"_resolved":"C:\\Users\\HP\\AppData\\Local\\Temp\\dda2118e29fa55c93c4d0c333f504687\\agent-economy-wallet-mcp-server-1.0.0.tgz","_integrity":"sha512-6ceXS3uo8a43eWUC8raflU2R7E854o4wG2ISdQzNNpFK4IB/h0hMugZ8swjU1/Lo1ct26cNID/wyYhxpAYZv4A==","_npmVersion":"11.0.0","description":"MCP server exposing Solana agent economy wallet tools for AI agents","directories":{},"_nodeVersion":"24.11.0","dependencies":{"zod":"^3.23.0","dotenv":"^16.4.5","express":"^5.2.1","@solana/web3.js":"^1.95.0","@solana/spl-token":"^0.4.14","@modelcontextprotocol/sdk":"^1.12.1","@agent-economy-wallet/core":"1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^5.0.0","typescript":"^5.4.0","@types/node":"^20.14.0","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1774959256326_0.4142435096970769","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@agent-economy-wallet/mcp-server","version":"1.0.1","description":"MCP server exposing Solana agent economy wallet tools for AI agents","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"},"./api/server":{"import":"./dist/api/server.js","types":"./dist/api/server.d.ts"}},"bin":{"agent-economy-wallet-mcp":"dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","@solana/spl-token":"^0.4.14","@solana/web3.js":"^1.95.0","dotenv":"^16.4.5","express":"^5.2.1","zod":"^3.23.0","@agent-economy-wallet/core":"1.0.1"},"devDependencies":{"@types/express":"^5.0.6","@types/node":"^20.14.0","rimraf":"^5.0.0","typescript":"^5.4.0"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","clean":"rimraf dist"},"_id":"@agent-economy-wallet/mcp-server@1.0.1","_integrity":"sha512-7l//L8j7OHrkRjgzhpt5c1UM90S6BAkgm0AovH3ndnEOwWD9Hmo7/XUvHXNR54oAkV5yJW1e36DRfm9l7lat3w==","_resolved":"C:\\Users\\HP\\AppData\\Local\\Temp\\c65401deb63b0bca5340521e01bebf0d\\agent-economy-wallet-mcp-server-1.0.1.tgz","_from":"file:agent-economy-wallet-mcp-server-1.0.1.tgz","_nodeVersion":"24.11.0","_npmVersion":"11.0.0","dist":{"integrity":"sha512-7l//L8j7OHrkRjgzhpt5c1UM90S6BAkgm0AovH3ndnEOwWD9Hmo7/XUvHXNR54oAkV5yJW1e36DRfm9l7lat3w==","shasum":"cefa9ac0679f925f9c409cd40056bc09023b1b7d","tarball":"https://registry.npmjs.org/@agent-economy-wallet/mcp-server/-/mcp-server-1.0.1.tgz","fileCount":234,"unpackedSize":374031,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC6aNTdG5b1ydNk4Hcica3jviJNh+VYof0ZPgkpi5c9jQIgW7qSKcX5ApDrO70xDAaGLRzyoiL9S1Yvf7VgX8oRUgc="}]},"_npmUser":{"name":"xavierscript","email":"david111francisco@gmail.com"},"directories":{},"maintainers":[{"name":"xavierscript","email":"david111francisco@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.0.1_1774961320709_0.9068233744749161"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T12:14:16.146Z","modified":"2026-03-31T12:48:41.043Z","1.0.0":"2026-03-31T12:14:16.471Z","1.0.1":"2026-03-31T12:48:40.877Z"},"description":"MCP server exposing Solana agent economy wallet tools for AI agents","maintainers":[{"name":"xavierscript","email":"david111francisco@gmail.com"}],"readme":"# @agent-economy-wallet/mcp-server\n\nThe [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for the Agent Economy Wallet. Exposes **18 tools**, **9 resources**, and **5 prompts** so that AI agents like Claude can autonomously hold Solana wallets, discover on-chain merchants, and pay for services — without any human writing a line of code per transaction.\n\n## Installation\n\n```bash\npnpm add @agent-economy-wallet/mcp-server\n```\n\n```bash\nnpm install @agent-economy-wallet/mcp-server\n```\n\n> **Node.js ≥ 18 required.**\n\n---\n\n## Environment Variables\n\n```env\n# Required\nWALLET_PASSPHRASE=your-strong-passphrase-here\nSOLANA_RPC_URL=https://api.devnet.solana.com\nSOLANA_CLUSTER=devnet\nOWNER_ADDRESS=YourBase58PublicKeyHere\nAGENT_NAME=my-agent\nAGENT_DESCRIPTION=What this agent does\n\n# Optional — auto-fund new wallets from a master key\nMASTER_WALLET_KEY_LABEL=master-funder\n\n# Optional — gasless transactions via Kora relay\nKORA_RPC_URL=http://localhost:8080\n```\n\n---\n\n## Connecting to Claude Desktop\n\nAdd the server to your MCP client config, then restart the client:\n\n### From npm (published package) — Recommended\n\n```json\n{\n  \"mcpServers\": {\n    \"agent-economy-wallet\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agent-economy-wallet/mcp-server\"],\n      \"env\": {\n        \"WALLET_PASSPHRASE\": \"your-strong-passphrase-here\",\n        \"SOLANA_RPC_URL\": \"https://api.devnet.solana.com\",\n        \"SOLANA_CLUSTER\": \"devnet\",\n        \"OWNER_ADDRESS\": \"YourBase58PublicKeyHere\",\n        \"AGENT_NAME\": \"my-agent\"\n      }\n    }\n  }\n}\n```\n\n### From local monorepo (development)\n\n```json\n// macOS: ~/Library/Application Support/Claude/claude_desktop_config.json\n// Windows: %APPDATA%\\Claude\\claude_desktop_config.json\n{\n  \"mcpServers\": {\n    \"agent-economy-wallet\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/packages/mcp-server/dist/index.js\"]\n    }\n  }\n}\n```\n\n---\n\n## Tools (18)\n\nTools give your AI agent the ability to **act**. Each has a typed input schema that Claude can parse and invoke autonomously.\n\n### Wallet Management\n\n| Tool | Input | Description |\n|------|-------|-------------|\n| `create_wallet` | `label: string` | Generate a new AES-256-GCM encrypted wallet |\n| `list_wallets` | *(none)* | List all wallet IDs and public keys |\n| `get_balance` | `wallet_id: string` | SOL + all SPL token balances |\n| `get_audit_logs` | `wallet_id?: string` | Recent transaction history and policy decisions |\n| `get_status` | *(none)* | Cluster, RPC, and Kora relay telemetry |\n| `get_policy` | `wallet_id?: string` | Active spending policy and usage counters |\n\n### Transfers\n\n| Tool | Input | Description |\n|------|-------|-------------|\n| `send_sol` | `wallet_id, to, amount` | Policy-enforced SOL transfer |\n| `send_token` | `wallet_id, mint, to, amount` | SPL token transfer with automatic ATA creation |\n| `write_memo` | `wallet_id, message` | Publish an on-chain SPL Memo (used for registry) |\n\n### Tokens\n\n| Tool | Input | Description |\n|------|-------|-------------|\n| `mint_tokens` | `wallet_id, mint, amount, to?` | Mint SPL tokens (requires mint authority) |\n\n### Payments (x402)\n\n| Tool | Input | Description |\n|------|-------|-------------|\n| `probe_x402` | `url: string` | Discover x402 price without paying |\n| `pay_x402_invoice` | `wallet_id, url, method?, body?` | Pay for gated endpoint and receive data |\n\n### Merchant Services\n\n| Tool | Input | Description |\n|------|-------|-------------|\n| `fetch_prices` | `tokens: string[]` | Live token prices via Jupiter aggregator |\n| `analyze_token_security` | `mint_address: string` | Token security analysis (mint/freeze authority) |\n\n### Discovery\n\n| Tool | Input | Description |\n|------|-------|-------------|\n| `discover_registry` | *(none)* | Scan Solana for all registered merchants |\n| `read_manifest` | `manifest_url: string` | Read a merchant's `.well-known/agent.json` |\n| `check_reputation` | `reputation_url: string` | Check trust score and success rate |\n\n> **Note:** `close_wallet` is intentionally excluded from MCP tools. Wallet closure is a destructive human-only operation restricted to the CLI.\n\n---\n\n## Resources (9)\n\nResources give your AI agent **read-only access** to the system's internal state:\n\n| Resource URI | Description |\n|---|---|\n| `wallet://all` | All managed wallets and their balances |\n| `wallet://{id}` | Detailed info for a specific wallet |\n| `wallet://{id}/policy` | Spending policy and usage counters |\n| `audit://logs` | Global transaction audit log |\n| `audit://{id}/logs` | Per-wallet audit log |\n| `system://status` | RPC connection and Kora relay health |\n| `system://config` | Non-sensitive runtime configuration |\n| `payments://x402-config` | Configured payment limits |\n| `trading://strategies` | Available trading strategy definitions |\n\n---\n\n## Prompts (5)\n\nDynamic prompt templates that guide Claude through common workflows:\n\n| Prompt | Description |\n|--------|-------------|\n| `wallet-setup` | Guided wallet initialization and funding |\n| `daily-report` | Generate a wallet activity digest |\n| `risk-assessment` | Evaluate policy violations and spending risks |\n| `security-audit` | Review keystore and policy configuration |\n| `x402-payment` | Walk through a full merchant discovery + payment flow |\n\n---\n\n## REST API (Express)\n\nThe server also exposes HTTP endpoints for direct access:\n\n| Endpoint | Auth | Description |\n|----------|------|-------------|\n| `GET /.well-known/agent.json` | None | Service manifest for buyer discovery |\n| `GET /reputation` | None | Success rate, tx count, uptime |\n| `GET /registry` | None | All registered on-chain agents |\n| `GET /api/fetch-price/:token` | x402 (0.05 USDC) | Live token price |\n| `GET /api/analyze-token/:address` | x402 (0.1 USDC) | Token security analysis |\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md"}