AI Assistant (MCP)

What is MCP?

MCP (Model Context Protocol) lets AI assistants like Kiro, Claude Desktop, and Cursor connect directly to your CompactSaaS account. Your AI can read analytics, create links, generate QR codes, and manage bio pages and wallet passes — all through natural conversation.

Setting up

Add this to your AI tool's MCP configuration:

{
  "mcpServers": {
    "compactsaas": {
      "url": "https://mcp.compactsaas.com/v1/mcp"
    }
  }
}

When you first use it, a browser window opens for you to log in with your CompactSaaS account (OAuth 2.1, with MFA). No API keys are needed. Your session is scoped to your team — you can only access your own data. See the MCP server getting started guide for client-specific configuration (Claude Desktop, Cursor, Kiro).

What can it do?

The MCP server exposes tools across every product area:

Analytics — stats, timeseries, breakdowns, realtime, period comparisons, and orphan detection.
Links — create, edit, and delete short links and redirects; list platform short domains.
QR codes — create, list, and delete codes and presets.
Wallet passes — create and manage Apple Wallet passes.
Bio pages — create and manage link-in-bio pages, including avatar images uploaded through short-lived presigned upload URLs (no base64 in context) and event-tracked passes.
Account — API keys, custom domains, team members, usage and billing, and documentation search.

Every successful mutation returns a structured response with a deep-link dashboardUrl, an inline billing cost preview for billable actions, optional manualSteps for anything MCP cannot finish, and an auditId for correlation.

The live tool list

The exact set of tools — and their current count — evolves as features ship. The authoritative, always-current list is available in-session by calling the get-account-info tool, which reads directly from the running server registry. A human-readable snapshot is also published at /docs/mcp-tools.md.

Developer API

Prefer plain HTTP? The same capabilities for links, analytics tracking, and bio pages are available over the customer REST API with API-key auth. Start with the Customer API getting started guide or open the interactive API Explorer.