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
- Your website redirects the user to
/app/oauth2/authorize. - The user clicks "Approve" on the ModVC consent screen.
- ModVC redirects the user back with an authorization
code. - 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