The Outseta Admin MCP Server allows AI assistants like Claude, Cursor, and other MCP-compatible tools to interact with your Outseta account using natural language. Instead of navigating the Outseta dashboard or writing API code, you can simply ask the AI to perform tasks like creating plans, managing subscriptions, or querying account data.

Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external tools and data sources. The Outseta MCP Server implements this protocol, giving AI agents direct access to Outseta's Admin API.

Relevant resources:

👉 @outseta/admin-mcp-server on npm
👉 GitHub repository
👉 Getting started with the Outseta API
👉 Model Context Protocol documentation

Prerequisites

Before setting up the MCP server, you'll need:

  1. Outseta API credentials — Generate an API Key and Secret from Settings > Integrations > API Keys in your Outseta dashboard
  2. Your Outseta subdomain — This is the first part of your Outseta URL (e.g., mycompany from mycompany.outseta.com)
  3. An MCP-compatible AI client — Such as Claude Desktop, Cursor, VS Code with Copilot, or Claude Projects

⚠️ Security Note: Your API credentials grant full admin access to your Outseta account. Keep them secure and never share them publicly.

Setup for Claude Desktop

To use the Outseta MCP Server with Claude Desktop, add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "outseta": {
      "command": "npx",
      "args": ["-y", "@outseta/admin-mcp-server"],
      "env": {
        "OUTSETA_API_KEY": "your_api_key",
        "OUTSETA_API_SECRET": "your_api_secret",
        "OUTSETA_SUBDOMAIN": "your_subdomain"
      }
    }
  }
}

After saving the configuration, restart Claude Desktop. You should see the Outseta tools available in the tools menu.

Setup for Cursor / VS Code

For Cursor or VS Code with MCP support, add the server configuration to your MCP settings:

{
  "mcpServers": {
    "outseta": {
      "command": "npx",
      "args": ["-y", "@outseta/admin-mcp-server"],
      "env": {
        "OUTSETA_API_KEY": "your_api_key",
        "OUTSETA_API_SECRET": "your_api_secret",
        "OUTSETA_SUBDOMAIN": "your_subdomain"
      }
    }
  }
}

Available Tools

The Outseta MCP Server provides tools organized into the following categories:

Accounts & CRM

  • get_accounts — Query accounts with filtering, pagination, and search. Supports filtering by fields like subscription status, plan, created date, and more.
  • register_account — Create a new account with a person and subscription in one operation.

People

  • get_people — Query people with filtering and pagination.
  • create_person — Create a standalone person (useful for email lists or support tickets).
  • add_person_to_account — Link an existing person to an account, with options for primary contact and welcome email.

Plans & Billing

  • get_plans — List all subscription plans.
  • get_plan_families — List plan families (groups of related plans).
  • create_plan — Create a new subscription plan with pricing tiers.
  • create_plan_family — Create a new plan family.
  • preview_subscription_change — Preview what happens when changing an account's plan (shows proration, timing, etc.).
  • change_subscription — Execute a subscription plan change for an account.

Email Marketing

  • get_email_lists — List all email lists.
  • create_email_list — Create a new email list with optional welcome email configuration.
  • get_email_list_subscribers — Get all subscribers for a specific email list.
  • subscribe_to_email_list — Subscribe a person to an email list.

Example Prompts

Here are some examples of what you can ask the AI to do:

Querying Data

  • "Show me all accounts on the Pro plan"
  • "Find the account for [email protected]"
  • "List all active subscription plans"
  • "How many subscribers are on my newsletter list?"
  • "Show me accounts created in the last 30 days"

Managing Subscriptions

  • "Preview what happens if I upgrade Acme Corp to the Enterprise plan"
  • "Change the subscription for account XYZ to the annual Pro plan"
  • "Create a new plan called 'Starter' at $29/month"

People & Accounts

Email Lists

  • "Create a new email list called 'Product Updates'"
  • "Subscribe [email protected] to the newsletter list"
  • "Show me all my email lists and their subscriber counts"

Tips for Best Results

  • Be specific: Include names, emails, or UIDs when referring to specific accounts or people.
  • Preview before changing: For subscription changes, ask the AI to preview the change first so you can review proration and timing.
  • Confirm destructive actions: The AI will ask for confirmation before creating or modifying data.
  • Use filters: When querying large datasets, specify filters to narrow down results (e.g., "accounts created after January 1st" or "people with gmail addresses").

Troubleshooting

Server not connecting: Ensure your API credentials are correct and that you have Node.js installed (required for npx).

Permission errors: Verify your API key has the necessary permissions in Outseta Settings.

Tools not appearing: Restart your AI client after updating the configuration file.

What's Next

The Outseta MCP Server is actively being developed. Future updates may include additional tools for:

  • Deal and pipeline management
  • Support ticket operations
  • Webhook configuration
  • Custom field management

Contributing

The Outseta Admin MCP Server is open source. If you'd like to contribute, report issues, or request features, visit the GitHub repository.