aptos-wallet-mcp
Aptos Wallet MCP Skill
When & Why to Use This Skill
The Aptos Wallet MCP Skill is a specialized integration designed for the Model Context Protocol (MCP), enabling Claude agents to interact seamlessly with the Aptos blockchain. It empowers users to manage wallets, query real-time on-chain data, and execute complex transactions such as token swaps and staking through natural language. By bridging the gap between AI agents and the Aptos ecosystem, it simplifies blockchain operations for both developers and DeFi users.
Use Cases
- Automated Portfolio Tracking: Monitor APT balances and transaction histories across multiple mainnet and testnet accounts directly within the chat interface.
- DeFi Operations via Natural Language: Execute token swaps on major Aptos DEXs like Liquidswap, Pancakeswap, and Thala without leaving the agent environment.
- Secure Asset Management: Perform fund transfers and staking operations with a structured approval workflow for enhanced security.
- Blockchain Development Integration: Streamline the development lifecycle by using the agent to validate wallet configurations, check pending transactions, and test network interactions.
| name | aptos-wallet-mcp |
|---|---|
| description | Aptos Wallet MCP Skill |
| version | 1.0.0 |
Aptos Wallet MCP Skill
Trit: 0 (ERGODIC) Domain: blockchain, wallet, mcp
Overview
Compressed, shareable Aptos wallet MCP configuration with GF(3) conservation.
Wallets
| Wallet | Network | Balance | Trit | Role |
|---|---|---|---|---|
| alice | mainnet | 0.6130 APT | -1 | MINUS/validator |
| bob | mainnet | 55.6987 APT | +1 | PLUS/executor |
| alice | testnet | 0.0000 APT | 0 | ERGODIC |
| bob | testnet | 0.0000 APT | 0 | ERGODIC |
MCP Server Config
{
"alice-aptos": {
"command": "node",
"args": ["${APTOS_MCP_PATH}/dist/mcp/server.js"],
"env": {
"APTOS_NETWORK": "mainnet",
"APTOS_PRIVATE_KEY": "${ALICE_APTOS_KEY}"
}
},
"bob-aptos": {
"command": "node",
"args": ["${APTOS_MCP_PATH}/dist/mcp/server.js"],
"env": {
"APTOS_NETWORK": "mainnet",
"APTOS_PRIVATE_KEY": "${BOB_APTOS_KEY}"
}
}
}
Tools
| Tool | ReadOnly | Approval |
|---|---|---|
aptos_balance |
yes | no |
aptos_view |
yes | no |
aptos_pending |
yes | no |
aptos_transfer |
no | yes |
aptos_swap |
no | yes |
aptos_stake |
no | yes |
aptos_intent |
no | yes |
aptos_approve |
no | yes |
DEX Integrations
- liquidswap
- pancakeswap
- thala
GF(3) Conservation
alice(-1) + bob(+1) + arbiter(0) = 0 (mod 3) ✓
Environment Template
export APTOS_MCP_PATH="$HOME/aptos-claude-agent"
export ALICE_APTOS_KEY="0x..."
export BOB_APTOS_KEY="0x..."
Commands
# Check balances
just aptos-balance alice
just aptos-balance bob
# Validate wallet config
just aptos-validate-all
Scientific Skill Interleaving
This skill connects to the K-Dense-AI/claude-scientific-skills ecosystem:
Graph Theory
- networkx [○] via bicomodule
- Universal graph hub
Bibliography References
general: 734 citations in bib.duckdb
Cat# Integration
This skill maps to Cat# = Comod(P) as a bicomodule in the equipment structure:
Trit: 0 (ERGODIC)
Home: Prof
Poly Op: ⊗
Kan Role: Adj
Color: #26D826
GF(3) Naturality
The skill participates in triads satisfying:
(-1) + (0) + (+1) ≡ 0 (mod 3)
This ensures compositional coherence in the Cat# equipment structure.