unwall

One token. All platforms. Real budget enforcement. Free.

A CLI + MCP server that gives AI agents such as OpenClaw, and more — access to paid services through a single Unwall wallet. Manage ads across Meta, Google, and X today; LLMs, data APIs, and compute tomorrow.

Why

• Free — no per-call fees, no monthly subscription
• One token — UNWALL_TOKEN replaces scattered API keys across Meta, Google, X
• Hard budget enforcement — Formance ledger rejects overspend; no markdown "guardrails" an LLM can ignore
• Campaigns created PAUSED — nothing goes live without explicit activation
• Audit trail — every tool call logged to a double-entry ledger

Quick Start

CLI (primary)

# Check what's connected
npx unwall status

# List Meta campaigns
npx unwall meta campaigns list --account 123456

# Create a Google Ads campaign (PAUSED by default)
npx unwall google campaigns create --customer 9876543210 --name "Summer Sale" --campaign-type SEARCH --daily-budget-micros 5000000 --bidding-strategy MAXIMIZE_CLICKS

# Get X Ads analytics
npx unwall x analytics get --account abc --entity CAMPAIGN --entity-ids id1,id2 --start-time 2026-01-01 --end-time 2026-03-01

MCP Server

Works with any MCP-compatible client — Claude Code, OpenClaw and others

npx unwall serve

Add to your MCP client config:

{
  "mcpServers": {
    "unwall": {
      "command": "npx",
      "args": ["unwall", "serve"],
      "env": { "UNWALL_TOKEN": "sk_proj_xxx" }
    }
  }
}

Get your project token at unwall.xyz.

CLI Commands

unwall status                                    # Connected platforms + balance
unwall balance                                   # Wallet balance
unwall serve                                     # Start MCP server

unwall meta campaigns list --account <id>        # Meta Ads
unwall meta campaigns create --account <id> --name <name> --objective <obj>
unwall meta adsets list --account <id>
unwall meta ads list --account <id>
unwall meta insights get --object-id <id>
unwall meta audiences list --account <id>

unwall google campaigns list --customer <id>     # Google Ads
unwall google campaigns create --customer <id> --name <name> --campaign-type SEARCH
unwall google adgroups list --customer <id>
unwall google keywords research --customer <id> --keywords "shoes,sneakers"
unwall google report get --customer <id> --date-range LAST_30_DAYS

unwall x campaigns list --account <id>           # X Ads
unwall x campaigns create --account <id> --data '{"name":"...","funding_instrument_id":"..."}'
unwall x line-items list --account <id>
unwall x analytics get --account <id> --entity CAMPAIGN --entity-ids id1
unwall x audiences list --account <id>

All output is JSON — pipe to jq or let your agent parse it directly.

MCP Tools (29 total)

When running as an MCP server (via OpenClaw, Claude Code, Cursor, etc.), only tools for your connected platforms appear. Connect platforms at unwall.xyz/dashboard.

Meta Ads (12 tools)

| Tool | Type | Description | |------|------|-------------| | ads_meta_list_campaigns | read | List campaigns with optional status filtering | | ads_meta_list_adsets | read | List ad sets, optionally filtered by campaign | | ads_meta_list_ads | read | List ads, optionally filtered by ad set | | ads_meta_get_insights | read | Get performance insights for any ad object | | ads_meta_list_audiences | read | List custom audiences | | ads_meta_create_campaign | write | Create a campaign (PAUSED by default) | | ads_meta_update_campaign | write | Update campaign name, status, or budget | | ads_meta_create_adset | write | Create an ad set (PAUSED by default) | | ads_meta_update_adset | write | Update ad set targeting, budget, or status | | ads_meta_create_ad | write | Create an ad (PAUSED by default) | | ads_meta_update_ad | write | Update ad creative or status | | ads_meta_upload_image | write | Upload an image from URL |

Google Ads (9 tools)

| Tool | Type | Description | |------|------|-------------| | ads_google_list_campaigns | read | List campaigns with optional status filtering | | ads_google_list_ad_groups | read | List ad groups, optionally filtered by campaign | | ads_google_keyword_research | read | Generate keyword ideas from seed keywords | | ads_google_get_performance_report | read | Get performance metrics with custom date ranges | | ads_google_create_campaign | write | Create a campaign (PAUSED by default) | | ads_google_update_campaign | write | Update campaign name, status, or budget | | ads_google_create_ad_group | write | Create an ad group (PAUSED by default) | | ads_google_create_responsive_search_ad | write | Create a responsive search ad | | ads_google_add_negative_keywords | write | Add negative keywords to a campaign |

X Ads (8 tools)

| Tool | Type | Description | |------|------|-------------| | ads_x_list_campaigns | read | List campaigns with optional status filtering | | ads_x_list_line_items | read | List line items, optionally filtered by campaign | | ads_x_get_analytics | read | Get analytics for campaigns, line items, or tweets | | ads_x_list_audiences | read | List tailored audiences | | ads_x_create_campaign | write | Create a campaign (PAUSED by default) | | ads_x_update_campaign | write | Update campaign name, status, or budget | | ads_x_create_line_item | write | Create a line item (PAUSED by default) | | ads_x_create_promoted_tweet | write | Promote a tweet through a line item |

Architecture

MCP Client (OpenClaw / Claude Code / Cursor / any MCP host)
  │
  ├── CLI commands             ─── unwall meta campaigns list
  ├── MCP protocol             ─── unwall serve
  │
  ▼
unwall (TypeScript, runs locally)
  │
  ├── Auth: sk_proj_xxx → Unwall API → per-platform OAuth tokens
  ├── Budget gate: hard balance + limit check before write tools
  ├── Audit: every tool call logged to Formance ledger
  │
  ├──► Meta Marketing API (Graph API v22)
  ├──► Google Ads API (REST v18)
  └──► X Ads API (v12)

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | UNWALL_TOKEN | Yes | Your Unwall project token (sk_proj_xxx) | | GOOGLE_ADS_DEVELOPER_TOKEN | For Google | Google Ads API developer token |

Development

git clone https://github.com/unwall-xyz/unwall.git
cd unwall
npm install
npm run build
UNWALL_TOKEN=sk_proj_xxx npm start

Contributing

Contributions welcome. Please keep changes focused and test before submitting.

License

MIT