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, and generate QR codes — 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.
• 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.