Wizpay Mcp Setup

Welcome to WizPay, an independent, self-hosted, unified checkout engine and storefront orchestration framework designed specifically for Philippine MSMEs. It enables merchants to instantly receive GCash, Maya, GrabPay, Visa/Mastercard, and Billease BNPL payments directly into their own accounts without middleman fees.

This repository is structured as a monorepo containing:

1. packages/web-app: A Next.js payment engine, hosted storefront builder, and Embeddable Storefront SDK (built with Firebase and Paymongo).
2. packages/mcp-server: A standalone Model Context Protocol (MCP) server that enables AI agents to configure, update, and embed WizPay checkout forms directly in your editor (e.g. Cursor, Claude Desktop, Antigravity).

Repository Structure

wizpay/
  ├── packages/
  │     ├── web-app/         # Next.js checkout platform & SDK
  │     └── mcp-server/      # TS-based MCP server
  ├── LICENSE                # MIT License
  ├── package.json           # npm workspaces configuration
  └── README.md              # This guide

Quick Start

1. Installation

From the root directory, install dependencies for all workspace projects:

npm install

2. Configure the Web Application (packages/web-app)

1. Create a Firebase project via the Firebase Console.
2. Enable Firestore Database and Authentication (Email/Password).
3. Copy the .env.example in packages/web-app to .env.local and populate it with your Firebase client & Admin SDK credentials:

   cp packages/web-app/.env.example packages/web-app/.env.local
   

4. Run the development server for the web app:

   npm run dev:web
   

   Open http://localhost:3000 to view the admin dashboard.

3. Configure the MCP Server (packages/mcp-server)

1. Build both packages:

   npm run build
   

2. Navigate to your WizPay Admin Dashboard (http://localhost:3000), go to Developer Settings, and generate an API key (wzp_live_...).

3. Run the automated MCP setup installer:

   [!TIP] For a zero-config setup, make sure your Next.js server is running (npm run dev:web) before running the installer. It will auto-detect the port and select local mode.

   npm run setup:mcp
   

   • Paste your Developer API key when prompted (find it in Developer Settings in your local dashboard).
   • If your local server is running, the script will auto-detect it. If offline, choose "Custom/Local Server" to target your local environment.
   • IDE Restart (First-Time Only): Restart your AI client (Cursor, Claude Desktop, or Antigravity) to load the tools.
   • Zero-Restart Updates: Future changes to your API key or server URL in the dashboard settings will take effect dynamically without requiring you to restart your client or conversation.

Scripts & Operations

Manage everything from the root directory:

• Install dependencies: npm install
• Run web dev server: npm run dev:web
• Build all projects: npm run build
• Setup MCP server: npm run setup:mcp

License

This project is open-source software licensed under the MIT License.