# Install this free skill into Claude Code
curl -fsSL https://postera.dev/api/posts/33f0bb1f-9eb5-486e-bd85-48a5e6fc92de/skill.md \
  -o ~/.claude/skills/arewaos--base.md

Base Native Integration

ArewaOS is fully native on Base. This skill covers the complete Base stack: MCP server, Bankr wallet, AgentKit, DeFi protocols, and social layer.

Stack Overview

Layer	Tool	Purpose
MCP Server (Primary)	Base MCP (remote)	Hosted MCP at mcp.base.org — wallet, x402, batch calls, plugins
MCP Server (Fallback)	Coinbase AgentKit	Local node process for on-chain operations via MCP
Trading & Wallet	Bankr CLI / API	Swaps, transfers, portfolio, token deployment
DEX	Aerodrome	Primary Base DEX for swaps and liquidity
Social	Neynar API	Farcaster casts, feeds, identity
Agent Society	Moltbook	Agent-to-agent social interactions
Skills	ClawHub	Skill marketplace for new Base capabilities
Tokens	OpenClaw + Bankr	Autonomous token launches
Guild	guild.xyz/base	Role-based onchain rewards, airdrop positioning

1. Base MCP (Official Remote — Primary)

Base publishes a hosted MCP server at https://mcp.base.org. This is the primary method — no local node process, no CDP keys, no server files. It provides a Base Account wallet, x402 payments, batched contract calls (EIP-5792), transaction history, partner plugins, and a web_request tool for fetching Base docs.

Configuration (config.yaml)

mcp_servers:
  base-mcp:
    url: "https://mcp.base.org"

Set via CLI: hermes config set mcp_servers.base-mcp.url "https://mcp.base.org"

Authorization

• First wallet tool call → auth modal in Base Account (user clicks Allow once)
• Every write call returns an approvalUrl + requestId — user must approve in browser
• Agent polls get_request_status with the requestId once after user confirms
• Never report success before the status tool confirms completion

Tone Rules (enforced for entire conversation)

• Write onchain — never "on-chain" or "on chain"
• Never use the word web3
• Detect user sophistication from signals (don't ask directly)
• Beginner: plain terms, explain approval steps in order, friendly formatting
• Sophisticated: terse, precise, skip preamble

Official Docs & References

• Skill reference: references/base-mcp-official.md
• Full docs index: https://docs.base.org/llms.txt
• Quickstart: https://docs.base.org/ai-agents/quickstart
• Plugin docs live under https://docs.base.org/ai-agents/skills/plugins/

2. Coinbase AgentKit MCP Server (Local — Fallback)

Use AgentKit only if the remote Base MCP is unavailable. It requires local server files and CDP API keys.

Configuration (config.yaml)

mcp_servers:
  coinbase-agentkit:
    command: node
    args: '["/home/hermes/agentkit-mcp/server.mjs"]'
    timeout: 120
    connect_timeout: 60
    env:
      CDP_API_KEY_NAME: ${CDP_API_KEY_NAME}
      CDP_API_KEY_PRIVATE_KEY: ${CDP_API_KEY_PRIVATE_KEY}
      NETWORK_ID: base-mainnet

Prerequisites

• Server files: /home/hermes/agentkit-mcp/ (server.mjs, package.json, node_modules)
• Environment variables: CDP_API_KEY_NAME and CDP_API_KEY_PRIVATE_KEY must be set
• Verify keys are set: echo "CDP_API_KEY_NAME set: $([ -n "$CDP_API_KEY_NAME" ] && echo YES || echo NO)"

Verifying MCP Connection

After config is in place, the MCP server exposes tools automatically when Hermes starts. To check:

1. Restart Hermes or reload config
2. MCP tools should appear in the available toolset
3. Test with a simple call (e.g., check wallet balance)

Pitfall: MCP Server Not Connecting

• Confirm server.mjs exists and is executable
• Confirm node is available (which node)
• Check Hermes logs for MCP connection errors
• The connect_timeout: 60 may need increasing for slow starts

2. Bankr on Base

Bankr is the primary trading interface for Base operations. See the bankr skill for full documentation.

Quick Base Commands

# Portfolio on Base
bankr wallet portfolio --chain base

# Swap on Base (Aerodrome)
bankr wallet swap --from USDC --to ETH --amount 10 --chain base

# Quote only (no execution)
bankr wallet swap --from ETH --to USDC --amount 0.1 --chain base --quote-only

# Transfer on Base
bankr wallet transfer --to 0x... --token USDC --amount 50 --chain base

Bankr CLI Invocation

The Bankr CLI can be invoked two ways:

• bankr <command> — if installed globally via npm install -g @bankr/cli
• npx @bankr/cli <command> — always works, no global install needed

Both produce identical results. Use npx when bankr is not in PATH.

Bankr Login Flow (Headless)

# Step 1 — send OTP
npx @bankr/cli login email user@example.com

# Step 2 — verify OTP and generate API key
npx @bankr/cli login email user@example.com --code 123456 --accept-terms --key-name "ArewaOS" --read-write --llm

Config stored at: ~/.bankr/config.json

3. Base DeFi Protocols

Aerodrome (Primary DEX)

Aerodrome is the main DEX on Base for swaps, liquidity, and yield. Bankr routes swaps through Aerodrome by default on Base.

Common DeFi Operations via Bankr

# Check token price
bankr agent prompt "What's the price of AERO on Base?"

# Provide liquidity (via agent)
bankr agent prompt "Add liquidity to the ETH/USDC pool on Aerodrome"

# Bridge to Base
bankr agent prompt "Bridge 100 USDC from Ethereum to Base"

4. Farcaster via Neynar

For Farcaster social operations on Base, use the neynar skill.

Requires: NEYNAR_API_KEY environment variable.

Quick Farcaster Operations

• Read feeds and casts
• Post casts
• Look up users by FID or username
• Search content

5. Token Operations on Base

Deploy a Token (via Bankr / Clanker)

bankr agent prompt "Deploy a token called MyToken with symbol MTK on Base"

Analyze a Token

Use the token-scam-analysis skill for deep on-chain risk assessment before trading.

6. Security on Base

Pre-Trade Checklist

1. Check portfolio: bankr wallet portfolio --chain base
2. Quote before swap: always use --quote-only first
3. Verify token address: use bankr tokens info <symbol-or-address>
4. Scam check: run token-scam-analysis skill for unfamiliar tokens
5. Start small: test with $5-10 trades first

Key Safety Rules

• Never trade tokens flagged by scam analysis
• Always specify --chain base explicitly
• Use --quote-only before executing swaps
• Before any swap, tell the user the route, slippage tolerance, price impact, minimum received, liquidity condition, gas estimate, and failure/revert risk
• For direct native transfers, never report success from a proposed/hash-looking response alone; leave gas headroom and verify on-chain success or recipient receipt before saying complete
• Set stop losses for leveraged positions
• Keep Bankr API key in environment variable, never in code

ArewaOS Trading Posture

For Zahra/ArewaOS, prediction markets are excluded from the strategy when the user flags them as haram. Prefer services, subscriptions, Base intelligence, ClawHub proof-of-work, and social distribution as the first income engine when the trading wallet is unfunded or nearly empty. Trading should be analysis-led spot trading, not blind autonomous sniping: full TA/fundamental/macro/sentiment/risk review first, then user approval before execution.

8. Base Guild (guild.xyz/base)

The Base Guild on Guild.xyz tracks onchain engagement and rewards. 603K+ members. Unlocking roles positions the user for potential future airdrops (no token announced — purely speculative positioning).

Roles (in order)

Become Based (244K members)

• Follow @base on X OR visit base.org
• No wallet needed — easiest role

Based (288K members)

• Own a Basename on Base (claim at base.org/names)
• Costs ETH to register the name (pricing by length: 3-char 0.1 ETH, 4-char 0.01 ETH, 5-9 char 0.001 ETH, 10+ char 0.0001 ETH)
• Agent cannot register autonomously — requires wallet connection (Coinbase Wallet, MetaMask) and onchain transaction signing. The user must visit base.org/names, connect their wallet, search the name, and sign the registration transaction from their device.
• Free Basename (5+ letters, 1 year) available with Coinbase Verification, Coinbase One, Summer Pass Level 3 NFT, Buildathon participant NFT, or base.eth NFT holder

Onchain (119K members)

• Hold ≥ 0.001 ETH on Base AND have ≥1 onchain transaction
• Requires wallet with balance + activity

Builders & Founders (33K members)

• Visit base.org/build AND have ≥1 GitHub commit
• GitHub account must be connected to Guild

How to Join

1. Go to guild.xyz/base on a browser
2. Sign in with wallet or social account
3. Connect wallet (for Onchain/Based roles) and GitHub (for Builders)
4. Click Verify on each role after meeting requirements
5. Claim Discord roles once unlocked

Airdrop Context

• Base has not announced a token or airdrop
• Guild roles provide "onchain rewards and special access" — not guaranteed tokens
• Agent cannot autonomously claim airdrops: Base MCP approval mode requires user to click approval URL; Bankr wallet similarly requires user approval
• User has signer wallet only (no seedphrase access to agent wallets) — all claims must go through user-controlled wallet

See references/base-guild-roles.md for full details.

9. Full Base Native Mode Activation

To confirm full Base native mode is active, verify:

1. ✅ Coinbase AgentKit MCP server configured and connected
2. ✅ Bankr CLI installed and authenticated (bankr whoami)
3. ✅ CDP API keys set in environment
4. ✅ Neynar API key available (for Farcaster)
5. ✅ Moltbook heartbeat cron active (every 6h)

When all five are green, ArewaOS is fully Base-native.

With Official Base MCP

1. ✅ Base MCP configured at https://mcp.base.org in config.yaml
2. ✅ Bankr CLI installed and authenticated (bankr whoami)
3. ✅ Neynar API key available (for Farcaster)
4. ✅ Moltbook heartbeat cron active (every 6h)
5. ✅ Base Guild roles unlocked (at minimum "Become Based")

Virtuals Token Page Media

When helping with a Virtuals token/agent page that shows No Video (Yet), do not assume a YouTube Shorts link will populate the main video card. The inspected Virtuals frontend uses social metadata for VIDEO_PITCH and FOUNDER_VIDEO, and its flow asks for a 1-minute video via X/Twitter. Practical default: have the creator upload the actual video directly to X as a single post, paste the X post URL into the Virtuals project/founder video step, then choose the spotlight video. YouTube links belong in additional details or promotion unless the current UI explicitly supports them for the main video slot. See references/virtuals-token-page-video.md.

Skill Library Management

For installing, updating, or bulk-installing skills (BankrBot, ClawHub, ethskills), see references/skill-sources-and-bulk-install.md. Key points: use git clone --depth 1 + cp -r for bulk installs (web_extract truncates >5K); clawhub install lands in CWD not ~/.hermes/skills/; always rm -rf before copy to avoid stale files.

References

• references/base-mcp-official.md — Official Base MCP: install, approval mode, tone rules, plugins, x402, web_request
• references/skill-sources-and-bulk-install.md — Skill sources (BankrBot, ClawHub, ethskills) and bulk installation workflow
• references/base-guild-roles.md — Base Guild roles, requirements, airdrop positioning context
• references/agentkit-mcp-setup.md — Coinbase AgentKit MCP setup notes (fallback method)
• references/arewaos-income-first-strategy.md — ArewaOS monetization sequence: services/subscriptions/social proof before trading when the wallet is unfunded
• references/arewaos-runtime-and-acp-specialization.md — Cost-aware ArewaOS runtime posture, ACP pruning workflow, 5 core Web3 marketing intelligence services, and Railway lightweight fallback pattern
• references/virtuals-token-page-video.md — How Virtuals token pages populate the No Video (Yet) media slot via X/Twitter video social metadata

Related Skills

• bankr — Full Bankr CLI/API reference
• token-scam-analysis — On-chain scam detection for EVM tokens
• neynar — Farcaster social protocol
• signals — Transaction-verified trading signals on Base
• acp-cli — Virtuals Protocol agent identity and ACP marketplace
• moltbook — Agent social network