Skip to main content

AgentWallet MCP Server

Give any AI agent a Solana wallet in one tool call.

MCP (Model Context Protocol) server that exposes the full AgentWallet Protocol as AI-native tools. Works with Claude Desktop, OpenClaw, Cursor, and any MCP-compatible client.

Quick Start

pip install agentwallet-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
    "mcpServers": {
        "agentwallet": {
            "command": "agentwallet-mcp",
            "env": {
                "AGENTWALLET_API_KEY": "aw_live_xxx",
                "AGENTWALLET_BASE_URL": "https://your-api.up.railway.app/v1"
            }
        }
    }
}

OpenClaw

Add to your OpenClaw config:

{
    "mcp": {
        "agentwallet": {
            "command": "agentwallet-mcp",
            "env": {
                "AGENTWALLET_API_KEY": "aw_live_xxx",
                "AGENTWALLET_BASE_URL": "https://your-api.up.railway.app/v1"
            }
        }
    }
}

Available Tools (26 tools)

Agents

Tool Description
create_agent Register an AI agent + auto-create its wallet
get_agent Get agent details by ID
list_agents List all agents (filter by status)
update_agent Update agent name, status, capabilities

Wallets

Tool Description
create_wallet Create a new Solana wallet
get_wallet Get wallet details
list_wallets List wallets (filter by agent/type)
get_balance Get SOL + token balances

Transactions

Tool Description
transfer_sol Send SOL (policy-enforced, fee-deducted, audited)
batch_transfer Batch SOL transfers
get_transaction Get transaction details
list_transactions Transaction history

Escrow

Tool Description
create_escrow Lock funds for agent-to-agent tasks
release_escrow Release funds on task completion
refund_escrow Refund if task not completed
dispute_escrow Raise a dispute
get_escrow Get escrow details
list_escrows List all escrows

Policies

Tool Description
create_policy Set spending limits, whitelists, time windows
list_policies List all policies
update_policy Modify policy rules
delete_policy Remove a policy

Analytics & Compliance

Tool Description
get_analytics_summary Org-level spending overview
get_daily_analytics Daily metrics and trends
get_agent_analytics Per-agent breakdowns
get_audit_log Immutable audit trail
get_anomalies Detected anomalies

Example Conversations

User: "Create a trading bot agent and give it a 10 SOL daily limit"

AI Agent:

  1. Calls create_agent(name="trading-bot", capabilities=["trading"])
  2. Calls create_policy(name="Daily Cap", rules={"daily_limit_lamports": 10000000000}, scope_type="agent", scope_id="<agent_id>")

User: "Set up an escrow — pay 2 SOL to worker-bot when it finishes the data analysis"

AI Agent:

  1. Calls create_escrow(funder_wallet="...", recipient_address="...", amount_sol=2.0, conditions={"task": "data-analysis"})
  2. Later: release_escrow(escrow_id="...") when task completes

Environment Variables

Variable Required Default Description
AGENTWALLET_API_KEY Yes -- Your API key (aw_live_xxx)
AGENTWALLET_BASE_URL No http://localhost:8000/v1 API endpoint

License

MIT — Build the agentic economy.

Metadata

Release files for agentwallet-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agentwallet-mcp 0.1.0
File Size Uploaded
agentwallet_mcp-0.1.0.tar.gz 7.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for agentwallet-mcp 0.1.0
File Interpreter ABI Platform
agentwallet_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 16.6 kB

Release files / agentwallet_mcp-0.1.0.tar.gz

Download URL agentwallet_mcp-0.1.0.tar.gz
Size 7.7 kB
Tags Source
SHA-256 checksum
How to use checksums
6dd71d4cf89f0fb1c160c7b1da04b8347d1ea6f78899c395213c8f63c25cefd2
BLAKE2b-256 checksum
How to use checksums
a407880704cfb48f008e5d115253ebffe8d61c6aa1343f57bdcac5a77d377b25
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release files / agentwallet_mcp-0.1.0-py3-none-any.whl

Download URL agentwallet_mcp-0.1.0-py3-none-any.whl
Size 8.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
be17db8146860828469caf6c97540d6ab603b739e9d4479cb13d81185e470d70
BLAKE2b-256 checksum
How to use checksums
fd815249300b0da3e7add150949b7d2caf2d1b1ca7ce8de40657085369b62b3b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page