Outseta Agent Toolkit

A collection of skills, templates, and 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.

Claude Code

Add to your ~/.claude.json:

{
  "mcpServers": {
    "outseta": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://n8n-webhooks.outseta.com/mcp/outseta"]
    }
  }
}

Cursor

1. Open Cursor Settings (Cmd + Shift + J / Ctrl + Shift + J)
2. Navigate to General > MCP
3. Click + Add New MCP Server
4. Enter:
   • Name: outseta
   • Type: command
   • Command: npx -y mcp-remote https://n8n-webhooks.outseta.com/mcp/outseta

Outseta Admin MCP

Enables direct interaction with your Outseta account for administrative operations (CRM, subscriptions, email lists, bulk data operations).

Claude Code

Add to your ~/.claude.json:

{
  "mcpServers": {
    "outseta-admin": {
      "command": "npx",
      "args": ["-y", "@outseta/admin-mcp-server"],
      "env": {
        "OUTSETA_SUBDOMAIN": "your-subdomain",
        "OUTSETA_API_KEY": "your-api-key",
        "OUTSETA_API_SECRET": "your-api-secret"
      }
    }
  }
}

Cursor

1. Open Cursor Settings (Cmd + Shift + J / Ctrl + Shift + J)
2. Navigate to General > MCP
3. Click + Add New MCP Server
4. Enter:
   • Name: outseta-admin
   • Type: command
   • Command: npx -y @outseta/admin-mcp-server
5. Add environment variables:
   • OUTSETA_SUBDOMAIN: your-subdomain
   • OUTSETA_API_KEY: your-api-key
   • OUTSETA_API_SECRET: your-api-secret

Note: The Admin MCP requires API credentials from your Outseta account (Settings > Integrations > API Keys). Keep these credentials secure and never commit them to version control.

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
└── 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