Introduction

AgentWallie

Agent-First Paywall Platform

AgentWallie is an API-first paywall management platform built for AI agents and developers. Every operation that traditional paywall tools do through a GUI, AgentWallie exposes through a structured REST API that doubles as an MCP server. The dashboard is just another client of that API -- never a separate control plane.

Key Differentiators

  • API-first, not GUI-first. Every entity (paywall, campaign, placement, audience, experiment, product) is a CRUD resource exposed via REST API.
  • Schema-defined paywalls. Paywalls are JSON documents, not visual editor state. A paywall spec declares components, layout, styles, products, and behavior. The SDK renders these natively. An agent creates a paywall by posting JSON -- no clicking, no canvas, no browser automation.
  • MCP as a first-class interface. The API maps 1:1 to MCP tools. Claude Code, Cursor, or any MCP-compatible agent can manage the entire paywall lifecycle without leaving the terminal.
  • Declarative campaigns. Campaign rules, audience filters, experiment configs, and placement mappings are all declarative JSON that agents can read, reason about, diff, and version.

Architecture

                         ┌──────────────────┐
                         │   Dashboard      │
                         │   (Next.js)      │
                         └────────┬─────────┘

┌──────────────┐    REST API      │
│  MCP Server  │◄─────────────────┤
│  (stdio/SSE) │                  │
└──────┬───────┘         ┌────────▼─────────┐
       │                 │   Backend API     │
       └────────────────►│   (Node.js)       │
                         │   Cloud Run       │
                         └────────┬─────────┘

                    ┌─────────────┼─────────────┐
                    │             │             │
             ┌──────▼───┐  ┌─────▼────┐  ┌─────▼────┐
             │ Postgres  │  │  Redis   │  │ClickHouse│
             │ (Supabase)│  │ (Cache)  │  │(Analytics)│
             └───────────┘  └──────────┘  └──────────┘

                    │  Config fetch + Event ingestion
              ┌─────┴──────┐
              │  iOS SDK   │
              │ Android SDK│
              └────────────┘

Quick Links

Tech Stack

ComponentTechnology
Backend APINode.js + TypeScript, Express
DatabasePostgreSQL (Supabase)
CacheRedis
AnalyticsClickHouse
iOS SDKSwift, SwiftUI, StoreKit 2
Android SDKKotlin, Jetpack Compose, Play Billing
DashboardNext.js + TypeScript + Tailwind
MCP ServerTypeScript, stdio + SSE transport
HostingGoogle Cloud Run