abstract-mcp

---
name: abstract-mcp
version: 1.0.0
description: Connect your .claw agent to Abstract Global Wallet via the official MCP server. Query balances, read Portal data, check XP, and interact with Abstract Chain — read-only in V1, transactions coming in V2.
homepage: https://mcp.abs.xyz
docs: https://docs.abs.xyz/abstract-global-wallet/overview
github: https://github.com/Abstract-Foundation/agw-sdk
metadata:
  category: utilities
  chain: abstract
  chain_id: 2741
  mcp_package: "@abstract-foundation/agw-mcp"
  mcp_version: "0.1.0"
  abstract_chain_promo: true
  openclaw_native: true
---

# Abstract MCP Skill

> *"Your agent speaks Abstract natively. Wallets, Portal, chain data — one MCP connection."*

The Abstract MCP skill connects your .claw agent to **Abstract Global Wallet (AGW)** via the official `@abstract-foundation/agw-mcp` server built by the Abstract team (Cygaar, Jarrod Watts).

**V1 is read-only** — balances, Portal apps, user profiles, chain queries. V2 will add transaction execution, swaps, and session key management.

---

## What Agents Can Do

| Capability | MCP Tool | Description |
|------------|----------|-------------|
| üí∞ **Check balances** | `get_balances` | Native ETH + all ERC-20 token balances |
| 🪙 **Token list** | `get_token_list` | Full ERC-20 holdings with metadata |
| 🏠 **Wallet address** | `get_wallet_address` | Linked AGW account address |
| üì± **Portal apps** | `portal_list_apps` | List all Abstract Portal applications |
| üîç **App details** | `portal_get_app` | Fetch specific Portal app info |
| üìä **User profile** | `portal_get_user_profile` | Portal profile by wallet address (XP, stats) |
| üåä **App streams** | `portal_list_streams` | Activity streams for a Portal app |
| ⛓️ **RPC calls** | `abstract_rpc_call` | Direct JSON-RPC to Abstract Chain |

### Blocked in V1 (Coming in V2)

- `eth_sendRawTransaction` — no signing/sending yet
- All `debug_*` methods
- Filter lifecycle (`eth_newFilter`, `eth_getFilterChanges`, etc.)
- `eth_subscribe` / `eth_unsubscribe`

---

## Quick Start

### 1. Initialize (link wallet)

```bash
./scripts/abstract-mcp-setup.sh init
```

This runs `npx @abstract-foundation/agw-mcp init --chain-id 2741`, which:
- Opens `https://mcp.abs.xyz` in your browser
- You connect your AGW wallet
- Writes session to `~/.agw-mcp/session.json`

### 2. Verify connection

```bash
./scripts/abstract-mcp-status.sh
```

### 3. Use with OpenClaw

The MCP server runs as a stdio transport. Add to your OpenClaw MCP config:

```json
{
  "mcpServers": {
    "agw": {
      "command": "npx",
      "args": ["-y", "@abstract-foundation/agw-mcp", "serve", "--chain-id", "2741"]
    }
  }
}
```

Or use the setup script:

```bash
./scripts/abstract-mcp-setup.sh config
```

### 4. Use with Claude Code

```bash
claude mcp add agw -- npx -y @abstract-foundation/agw-mcp serve --chain-id 2741
```

---

## Agent Workflows

### Check agent wallet status
```
Agent: "What's my wallet balance?"
‚Üí MCP: get_wallet_address ‚Üí get_balances
‚Üí "Your AGW 0x7a3...f92 holds 1.2 ETH + 943.50 USDC"
```

### Monitor Portal XP
```
Agent: "How much XP do I have on Abstract Portal?"
‚Üí MCP: portal_get_user_profile(address)
‚Üí "You have 12,450 XP across 3 Portal apps"
```

### Discover Portal apps
```
Agent: "What games can I play on Abstract?"
‚Üí MCP: portal_list_apps
‚Üí "Found 47 apps: Gigaverse, Blinko, ClankerZone, MoodyMights..."
```

### Chain query
```
Agent: "What block are we on?"
‚Üí MCP: abstract_rpc_call(eth_blockNumber)
‚Üí "Abstract mainnet block: 8,234,567"
```

---

## Security Model

- **Read-only in V1** — no signing, transfers, swaps, or deploys
- **Local-only transport** — stdio MCP, no network listener
- **Restrictive file permissions** — `~/.agw-mcp/` is `0700`, session file is `0600`
- **No private keys stored** — only wallet address + chain ID in session
- **Stderr-only logging** — stdout reserved for MCP transport

---

## Integration with ClawWallet

When a .claw agent has this skill installed:

1. **Auto-provisioning**: `abstract-mcp-setup.sh provision <wallet_address>` writes a session.json directly (no browser flow needed for managed agents)
2. **Heartbeat integration**: Agent can check Portal XP on heartbeat ticks
3. **Skill composition**: Combines with Gigaverse/Blinko/ClankerZone skills — agent checks balances before entering games
4. **Future**: When V2 ships transaction support, agents can execute swaps and transfers autonomously within ClawWallet's on-chain permission policies

---

## Files

```
skills/abstract-mcp/
├── SKILL.md              (this file)
├── README.md             (public-facing docs)
└── scripts/
    ├── abstract-mcp-setup.sh    (init, config, provision)
    └── abstract-mcp-status.sh   (verify connection, check tools)
```

---

## Upstream

- Package: [@abstract-foundation/agw-mcp](https://www.npmjs.com/package/@abstract-foundation/agw-mcp)
- Maintainers: cygaardev, coffeexcoin, jarrodwatts
- License: MIT
- Announced: Feb 24, 2026 by [@0xCygaar](https://x.com/0xCygaar/status/2026279233279136117)