MCP Server

The @akta/agent-wallet-mcp package provides a Model Context Protocol server that exposes agent wallet actions as MCP tools. This enables Claude Desktop and other MCP clients to interact with the Algorand blockchain.

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "akita-agent-wallet": {
      "command": "npx",
      "args": ["@akta/agent-wallet-mcp"],
      "env": {
        "ENV_FILE": "/absolute/path/to/.env"
      }
    }
  }
}

Any MCP Client

The server follows the standard MCP protocol and works with any compatible client:

ENV_FILE=/path/to/.env npx @akta/agent-wallet-mcp

MCP Tools

Every agent wallet action is registered as an MCP tool with:

• Name — The action name (e.g., send_payment)
• Description — Human-readable description
• Input schema — JSON Schema derived from the Zod schema

The AI agent sees all available tools and can invoke them naturally:

“Send 1 ALGO to RECIPIENT_ADDRESS”

The agent calls the send_payment tool with {"receiver": "RECIPIENT_ADDRESS", "amount": 1000000}

MCP Resources

The server exposes wallet state as MCP resources:

Resource	Description
Wallet config	Current wallet app ID, escrow name, network
Wallet balance	Current ALGO and ASA balances
Allowance status	Remaining spending allowances per asset

MCP Prompts

Pre-built prompts help the AI agent understand its capabilities:

Prompt	Description
wallet-overview	Describes the wallet setup, balances, and available actions
send-payment	Guides the agent through sending a payment

Environment Resolution

The MCP server loads environment variables in this order:

1. ENV_FILE environment variable pointing to a .env file
2. ./.env in the current working directory

All configuration is stored in the .env file generated by the setup wizard. See Quick Start for the full list of variables.