Schematic MCP

🚀 Schematic MCP Server

An MCP server that connects AI assistants to Schematic, a platform for managing billing, plans, features, and entitlements. Use this server to enable Claude, Cursor, or any MCP-compatible client to perform tasks such as looking up companies, managing plan entitlements, setting overrides, and creating features through natural language.

🚀 Quick Start

Prerequisites

1. Get your Schematic API key: Sign up for a Schematic account and obtain your API key from the Schematic dashboard.

📦 Installation

Option 1: Using Claude CLI (Recommended)

1. Install the package from npm:

npm i @schematichq/schematic-mcp

2. Add the MCP server to Claude:

claude mcp add --transport stdio --scope project schematic --env SCHEMATIC_API_KEY=your-api-key-here -- npx @schematichq/schematic-mcp

Replace your-api-key-here with your actual Schematic API key.

Option 2: Manual Configuration

Claude Desktop / Claude Code

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

{
  "mcpServers": {
    "schematic": {
      "command": "npx",
      "args": ["-y", "@schematichq/schematic-mcp"],
      "env": {
        "SCHEMATIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP config (Settings > MCP Servers, or edit the file directly):

• macOS: ~/.cursor/mcp.json
• Linux: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json

{
  "mcpServers": {
    "schematic": {
      "command": "npx",
      "args": ["-y", "@schematichq/schematic-mcp"],
      "env": {
        "SCHEMATIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

After adding the config, restart Cursor for the server to be recognized.

📚 Documentation

Configuration

The server requires a Schematic API key. It checks two sources in order:

1. Environment variable (recommended): SCHEMATIC_API_KEY
2. Config file (fallback): ~/.schematic-mcp/config.json

{
  "apiKey": "your-api-key-here"
}

You can find your API key in the Schematic dashboard.

Tools

Company Lookup

Company Overrides

Plan Management

Feature Management

Example Prompts

Once configured, you can try asking your AI assistant the following questions:

• "What plan is Acme Corp on?"
• "List all my plans and their features"
• "Create a boolean feature called 'Advanced Analytics'"
• "Set an override for Acme Corp to have unlimited API calls"
• "How many companies are on the Pro plan?"
• "Find the Schematic company linked to Stripe customer cus_abc123"

💻 Usage Examples

Development

# Install dependencies
yarn install

# Build
yarn build

# Run in development mode (auto-recompile on changes)
yarn dev

# Run tests
yarn test

📄 License

MIT