MCP server setup (Track B)

Track B uses an MCP server instead of the skill document. The agent calls tools like aicw_heartbeat() directly ??no Python code generation required.

View on PyPI ??

1. Install aicw-mcp

Windows (PowerShell / CMD)

Install from PyPI (recommended):

python -m pip install aicw-mcp

Or install from source:

git clone https://github.com/aicw-protocol/aicw_mcp.git
cd aicw_mcp
python -m pip install -e .

macOS / Linux

Install from PyPI (recommended):

pip3 install aicw-mcp

Or install from source:

git clone https://github.com/aicw-protocol/aicw_mcp.git
cd aicw_mcp
pip3 install -e .

2. Create environment file

Create ~/.aicw/aicw_mcp.env with your wallet credentials (from the Issue Wallet success modal):

MPC_WALLET_ID=your-mpc-wallet-uuid
AI_AGENT_PUBKEY=your-base58-solana-pubkey
MPC_BRIDGE_URL=https://bridge.aicw.ai
SOLANA_RPC_URL=https://api.devnet.solana.com
AICW_PROGRAM_ID=9RUEw4jcMi8xcGf3tJRCAdzUzLuhEurts8Z2QQLsRbaV

3. Platform-specific configuration

Cursor

Edit ~/.cursor/mcp.json (create if it doesn't exist):

{
  "mcpServers": {
    "aicw": {
      "command": "python",
      "args": ["-m", "aicw_mcp"],
      "envFile": "~/.aicw/aicw_mcp.env"
    }
  }
}

On Windows, use the full Python path (e.g., C:/Users/you/AppData/Local/Python/python.exe). Restart Cursor after saving.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "aicw": {
      "command": "python",
      "args": ["-m", "aicw_mcp"],
      "env": {
        "MPC_WALLET_ID": "your-uuid",
        "AI_AGENT_PUBKEY": "your-pubkey",
        "MPC_BRIDGE_URL": "https://bridge.aicw.ai"
      }
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "aicw": {
      "command": "python",
      "args": ["-m", "aicw_mcp"],
      "envFile": "~/.aicw/aicw_mcp.env"
    }
  }
}

VS Code (Cline / Roo Code)

Open Cline settings ??MCP Servers ??Add Server:

• Command: python
• Args: -m aicw_mcp
• Env file: ~/.aicw/aicw_mcp.env

4. Available tools

5. Verify installation

Test the server runs:

python -m aicw_mcp

In your agent, try saying "Check my AICW wallet status" ?? the agent should call aicw_check_survival().

Track A vs Track B

Both tracks use the same MPC Bridge and on-chain program. Choose one or use both together.