Outseta Agent Toolkit

A collection of skills, templates, and curated documentation for AI coding agents to integrate SaaS applications with Outseta - the all-in-one platform for authentication, billing, CRM, and customer support.

Quick Start

1. Install the skill: npx skills add outseta/agent-toolkit
2. Add agent instructions (see below)
3. Add MCP servers (see below)
4. Ask your agent: "Review the Outseta skill and help me integrate authentication"

Installation

1. Install the Skill

Install the Outseta skill using the skills CLI:

npx skills add outseta/agent-toolkit

This installs the templates and documentation into your project's .skills/ directory. See agentskills.io for more on agent skills.

Manual installation

If you prefer not to use the skills CLI, copy the skills/outseta/ directory from this repository into your project's .skills/ or skills/ folder.

2. Add Agent Instructions

Download the AGENTS.md file to your project root. This file provides core integration rules that agents will follow when working with Outseta.

curl -O https://raw.githubusercontent.com/outseta/agent-toolkit/main/AGENTS.md

Claude Code users

Also download CLAUDE.md for Claude-specific guidance:

curl -O https://raw.githubusercontent.com/outseta/agent-toolkit/main/CLAUDE.md

3. Add MCP Servers

Outseta Knowledge Base MCP

Provides real-time access to Outseta's knowledge base and API references.

This toolkit repository contains the curated skill, templates, and references used during implementation.

Claude Code

Add to your ~/.claude.json:

{
  "mcpServers": {
    "outseta": {
      "url": "https://mcp.outseta.com"
    }
  }
}

This will use the built-in OAuth authentication with Claude Code, it will take you to the Outseta website to log in.

If for some reason you don't want to use OAuth authentication, you can use API keys as well. See: Outseta MCP Server for AI Assistants

{
  "mcpServers": {
    "outseta": {
      "url": "https://mcp.outseta.com",
      "headers": {
        "Authorization": "Outseta <key>:<secret>",
        "X-Outseta-Subdomain": "<subdomain>.outseta.com"
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "outseta": {
      "url": "https://mcp.outseta.com"
    }
  }
}

Cursor will prompt you to authenticate via OAuth on the Outseta website the first time the server is used.

If for some reason you don't want to use OAuth authentication, you can use API keys as well. See: Outseta MCP Server for AI Assistants

{
  "mcpServers": {
    "outseta": {
      "url": "https://mcp.outseta.com",
      "headers": {
        "Authorization": "Outseta <key>:<secret>",
        "X-Outseta-Subdomain": "<subdomain>.outseta.com"
      }
    }
  }
}

Key Features

• Authentication - Outseta's "Magic Script" and embeddable widgets for login, sign-up, and profile management
• Subscriptions & Billing - Gate features based on subscription status using JWT claims or the REST API
• Data Sync - Use Outseta UIDs as foreign keys and webhooks for real-time updates
• REST API - Server-to-server communication for custom onboarding and admin tasks
• Framework Templates - Ready-to-use code for React and Node.js

Project Structure

├── AGENTS.md                    # Core integration rules for agents
├── CLAUDE.md                    # Claude-specific guidance
└── skills/outseta/
    ├── SKILL.md                 # Outseta concepts and patterns
    ├── templates/               # React, Node.js, and HTML snippets
    └── references/              # JWT, usage tracking, API guides

Example Project

See Outseta Vibe Coding Courses CMS for a complete project built with Roo Code using this toolkit.

Resources

• Outseta Knowledge Base - Official help center
• Agents.md - Standard for agent behaviors
• Agent Skills Spec - Specification for agent skills
• Skills Directory - Browse and install agent skills