App Fundamentals

Overview of ModVC Apps

Welcome to the ModVC Developer Platform. By building on ModVC, you can automate servers, create intelligent chat commands, and integrate Single Sign-On (SSO) securely across your entire network of websites.

Why build on ModVC?

Unlike traditional isolated chat apps, ModVC is built as a highly extensible platform. We provide developers with raw access to the underlying Turso SQL databases, Edge-based Presence APIs, and low-latency server management endpoints.

  • Zero-cost infrastructure: Run your bots entirely on Edge Workers.
  • Real-time Webhooks: Instantly receive events for Slash Commands and Component clicks.
  • SSO Out-of-the-Box: Authenticate millions of users using OAuth2 securely.

1. Server Bots & Automations

Bots are automated accounts that join ModVC servers. They look and act like regular users, complete with a unique "Bot" tag, but are entirely driven by your code.

Automated Moderation

Scan messages, kick rule-breakers automatically, and maintain audit logs without human intervention.

Slash Commands

Register custom commands that server members can type to interact with your external APIs.

2. Single Sign-On (SSO)

OAuth2 integrations allow users to securely authenticate with your third-party applications using their existing ModVC identity.

The SSO Flow

  1. Your website redirects the user to /app/oauth2/authorize.
  2. The user clicks "Approve" on the ModVC consent screen.
  3. ModVC redirects the user back with an authorization code.
  4. Your backend securely exchanges the code for a Bearer access_token.

Core Platform APIs

Bot API (Server Management)

Uses the Bot <token> header. Used for managing channels, sending rich messages, and moderating members.

OAuth2 API (Identity)

Uses the Bearer <token> header. Used for reading the authenticated user's profile data.

Ready to begin?

Head over to the Developer Portal to register your first application and receive your API credentials.

Open Developer Portal