WallMRR Documentation
WallMRR is a dedicated ambient display system for your subscription revenue metrics. It runs on any television or secondary screen with a modern web browser.
3-Step Onboarding
- Create an account & claim a handle: Sign in with Google or Email at wallmrr.com/login.
- Connect a data source: Add your credentials under Connections (Stripe restricted key, Polar token, RevenueCat, DataFa.st, or Stalkr key).
- Pair your TV: Open
wallmrr.com/tvon your screen, copy the 6-character code, and enter it at wallmrr.com/pair.
Pairing Displays via 6-Character Codes
Typing email addresses and passwords with a television remote control is frustrating and prone to shoulder-surfing. WallMRR uses zero-credential device pairing:
1. When wallmrr.com/tv loads on an unpaired screen, the TV calls POST /v1/tv/pair/start to receive an ephemeral 6-character code (valid for 10 minutes).
2. You visit wallmrr.com/pair from your laptop or phone while logged into your account and submit the code.
3. The backend validates account tier screen limits (Free allows 1 screen, Pro allows 2 screens, Studio allows 5 screens) and issues a long-lived device token. The TV immediately transitions to your live wall.
Connecting Payment Providers
Stripe
Always use a Restricted Key (rk_live_...), never your root secret key. WallMRR requires read-only permissions for:
- Subscriptions: Read
- Invoices: Read
- Charges & PaymentIntents: Read
- Customers: Read
Polar
Generate a Personal Access Token (polar_oat_...) under your Polar dashboard organization settings. WallMRR reads orders, subscriptions, and products to compute real-time MRR.
RevenueCat
Provide your V2 REST API Secret Key and your Project ID from the RevenueCat project settings. WallMRR ingests iOS and Android mobile subscriptions automatically.
Stalkr
Generate an API Key (stalkr_sk_...) from your Stalkr project settings. Optionally provide your Project ID (WallMRR will auto-discover your primary project if omitted). WallMRR tracks brand mentions, positive sentiment ratio, mentions today, and keyword quota on your TV screen.
DataFa.st
Provide a website API key (df_...) or account token (dft_...). WallMRR reads live visitors, 28-day analytics overview, and gross revenue directly from DataFa.st.
Wall Customization & Themes
Customize your layout directly from /dashboard/wall:
Multi-widget layout showing MRR, ARR, Active Subs, New Today, and Churn Rate side by side.
Ultra-clean large typography layout designed for viewing distances over 3 meters. Pro/Studio tier.
Model Context Protocol (MCP) & REST API
Connect Claude Desktop, Cursor, or your autonomous agent workflows directly to WallMRR via streamable HTTP Model Context Protocol. MCP is included in Pro and Studio; the public REST API is Studio's.
Security & Sandboxing
All credentials provided to WallMRR are encrypted at rest using AES-GCM before writing to PostgreSQL. Provider API keys are never rendered in client bundles, never logged in access logs, and never exposed on TV screens. TV devices only ever receive an isolated screen token that has no permission to read API keys or write billing settings.