home / skills / plurigrid / asi / aptos-wallet-mcp

aptos-wallet-mcp skill

safe

This skill manages compressed Aptos wallet MCP configurations and operations across mainnet and testnet, ensuring GF(3) conservation and secure tooling.

npx playbooks add skill plurigrid/asi --skill aptos-wallet-mcp

Review the files below or copy the command above to add this skill to your agents.

Files (2)

SKILL.md

2.8 KB

---
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

```json
{
  "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

```bash
export APTOS_MCP_PATH="$HOME/aptos-claude-agent"
export ALICE_APTOS_KEY="0x..."
export BOB_APTOS_KEY="0x..."
```

## Commands

```bash
# 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



## SDF Interleaving

This skill connects to **Software Design for Flexibility** (Hanson & Sussman, 2021):

### Primary Chapter: 10. Adventure Game Example

**Concepts**: autonomous agent, game, synthesis

### GF(3) Balanced Triad

```
aptos-wallet-mcp (−) + SDF.Ch10 (+) + [balancer] (○) = 0
```

**Skill Trit**: -1 (MINUS - verification)

### Secondary Chapters

- Ch5: Evaluation

### Connection Pattern

Adventure games synthesize techniques. This skill integrates multiple patterns.
## 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.

Overview

This skill provides a compact Aptos wallet MCP configuration and runtime helpers for managing multiple Aptos accounts with GF(3) conservation semantics. It bundles node-based MCP server entries, common Aptos tools (balance, view, pending, transfer, swap, stake, intent, approve), and integration pointers for common DEXes. The focus is practical wallet orchestration with verification-oriented roles and environment templates for quick deployment.

How this skill works

The skill exposes MCP server configurations for each wallet that run a Node MCP server process with environment-driven private keys and network selection. It includes read-only inspection tools and approved transaction tools that require explicit approval. The configuration enforces a GF(3) conservation check across declared trits to preserve a compositional invariant for multi-party coordination.

When to use it

Operate multiple Aptos wallets from a single MCP orchestrator on mainnet or testnet.
Run automated checks and balances before executing state-changing operations.
Integrate on-chain swaps, staking, or transfers with a controlled approval flow.
Validate wallet role assignments and GF(3) conservation before composing transactions.
Prototype DEX interactions (liquidswap, pancakeswap, thala) with wallet role separation.

Best practices

Keep private keys in environment variables and never commit them to source control.
Use read-only tools (aptos_balance, aptos_view, aptos_pending) to audit state before approvals.
Require manual approval for any aptos_transfer, aptos_swap, aptos_stake, aptos_intent operations.
Run aptos-validate-all regularly to ensure wallet configurations and trit invariants remain consistent.
Isolate mainnet and testnet configurations using separate MCP entries and environment templates.

Example use cases

Set up alice and bob MCP processes for mainnet operations while keeping testnet entries for simulation.
Query balances and pending transactions, then approve a cross-role transfer from PLUS to MINUS.
Validate GF(3) conservation across participants before executing multi-signer workflows.
Integrate a swap flow with liquidswap or pancakeswap using the aptos_swap tool and an approval step.
Automate staking and unstaking sequences with aptos_stake after manual verification steps.

FAQ

How do I supply private keys to the MCP servers?

Set environment variables (e.g., ALICE_APTOS_KEY, BOB_APTOS_KEY) and point APTOS_MCP_PATH to the MCP distribution before starting the node processes.

What does GF(3) conservation mean here?

Each wallet is assigned a trit (-1, 0, +1). The sum of trits across the configured participants must equal 0 modulo 3 to satisfy the compositional invariant used for verification and role balancing.