CompactSaaS MCP Server

Connect your AI tools (Claude Desktop, Cursor, Kiro, or any MCP-compatible client) to CompactSaaS and manage your setup without opening the dashboard.

Quick Start

Add this to your MCP client configuration:

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

Your MCP client will automatically discover the OAuth configuration and open a browser window for you to log in with your CompactSaaS credentials. No API keys needed.

Authentication

The MCP server uses OAuth 2.1 with your existing CompactSaaS account (Cognito). When you first connect:

Your MCP client discovers the OAuth server via /.well-known/oauth-protected-resource
A browser window opens for you to log in with your CompactSaaS email and password
After login, the MCP client receives a token and connects automatically
Your session is scoped to your team — you can only access your own data

Available Tools

Analytics

Tool	Description
`list-websites`	List all analytics websites configured for your account
`get-website`	Get details of a specific analytics website (requires `websiteId`)

Links

Tool	Description
`list-redirects`	List all URL redirects — source domain/path, target URL, status code
`list-short-links`	List all short links — short code, domain, target URL, click status

Configuration

Tool	Description
`list-api-keys`	List active API keys (prefix only, full key never exposed)
`list-domains`	List custom domains and their verification/activation status
`get-account-info`	Get your account information and list of available tools

Tool Details

`get-website`

Parameters:

Name	Type	Required	Description
`websiteId`	string	Yes	The website ID to look up

All other tools take no parameters.

Client Configuration Examples

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

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

Cursor

Add to your Cursor MCP settings:

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

Kiro

Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your project):

{
  "mcpServers": {
    "compactsaas": {
      "type": "http",
      "url": "https://mcp.compactsaas.com/v1/mcp",
      "oauth": {
        "oauthScopes": ["openid", "email"]
      }
    }
  }
}

Technical Details

Transport: Streamable HTTP (stateless)
Auth: OAuth 2.1 via Cognito (PKCE, authorization code grant)
Protocol: MCP specification 2025-03-26
Rate limit: 25 requests/second, burst 50

Troubleshooting

"No CompactSaaS team found" — Your Cognito account isn't linked to a team. Log into the dashboard first to complete onboarding.

Browser doesn't open for login — Your MCP client may not support OAuth auto-discovery. Check that it supports the MCP 2025-03-26 specification.

406 Not Acceptable — Your client must send Accept: application/json, text/event-stream header. Most MCP clients do this automatically.

Connection timeout — The MCP server endpoint may not be deployed yet. Check with your administrator.