Schematic
Manage companies, plans, features, and billing through SchematicHQ
Open source Open in the app JSON README (API)
About
Manage companies, plans, features, and billing through SchematicHQ
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- schematichq
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.4.0
- Stars
- 2
- Open pull requests
- 2
- Last push
- 2026-07-31T21:39:21Z
- Repository state
- arquivado
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:02:13
- Updated
- 2026-08-29 03:02:13
- Origin id
io.github.SchematicHQ/schematic-mcp
README
# Schematic MCP Server
> [!WARNING]
> **Deprecated.** Schematic now hosts an MCP server at `https://api.schematichq.com/mcp` — see the [Schematic MCP documentation](https://docs.schematichq.com/for-developers#model-context-protocol-mcp) to connect. This local stdio server still works but no longer receives new tools or fixes.
An [MCP](https://modelcontextprotocol.io/) server that connects AI assistants to [Schematic](https://schematichq.com) -- the platform for managing billing, plans, features, and entitlements.
Use this server to let Claude, Cursor, or any MCP-compatible client look up companies, manage plan entitlements, set overrides, create features, and more -- all through natural language.
## Quick Start
### Prerequisites
1. **Get your Schematic secret API key**: Sign up for a [Schematic account](https://schematichq.com) and get your **secret** API key from the [Schematic dashboard](https://app.schematichq.com). Note: use your secret API key, not the publishable key.
### Installation
#### Option 1: Using Claude CLI (Recommended)
1. Install the package from npm:
```bash
npm i @schematichq/schematic-mcp
```
2. Add the MCP server to Claude:
```bash
claude mcp add --transport stdio --scope project schematic --env SCHEMATIC_API_KEY=your-secret-api-key-here -- npx @schematichq/schematic-mcp
```
Replace `your-secret-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):
```json
{
"mcpServers": {
"schematic": {
"command": "npx",
"args": ["-y", "@schematichq/schematic-mcp"],
"env": {
"SCHEMATIC_API_KEY": "your-secret-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`
```json
{
"mcpServers": {
"schematic": {
"command": "npx",
"args": ["-y", "@schematichq/schematic-mcp"],
"env": {
"SCHEMATIC_API_KEY": "your-secret-api-key-here"
}
}
}
}
```
After adding the config, restart Cursor for the server to be picked up.
## Configuration
The server needs a Schematic **secret** API key (not the publishable key). It checks two sources in order:
1. **Environment variable** (recommended): `SCHEMATIC_API_KEY`
2. **Config file** (fallback): `~/.schematic-mcp/config.json`
```json
{
"apiKey": "your-secret-api-key-here"
}
```
You can find your secret API key in the [Schematic dashboard](https://app.schematichq.com).
### Custom API base URL (optional)
By default the server targets the production Schematic API. To point it at a local or non-production API, set `SCHEMATIC_API_URL`:
```json
{
"command": "npx",
"args": ["@schematichq/schematic-mcp"],
"env": {
"SCHEMATIC_API_KEY": "your-secret-api-key-here",
"SCHEMATIC_API_URL": "http://localhost:8080"
}
}
```
When unset, the SDK's production default is used.
## Tools
### Company Lookup
| Tool | Description |
|------|-------------|
| `get_company` | Look up a company by ID, name, Stripe customer ID, or [custom key](https://docs.schematichq.com/developer_resources/key_management). Returns details, plan, trial status, and links. |
| `create_company` | Create (upsert) a company identified by a [key](https://docs.schematichq.com/developer_resources/key_management) (`keyName`/`keyValue`), with an optional `name` and `traits`. Updates the company if the key already exists. |
| `get_company_plan` | Get the plan a company is currently on. |
| `get_company_trial_info` | Check if a company is on a trial and when it ends. |
| `count_companies_on_plan` | Count how many companies are on a specific plan. |
| `link_stripe_to_schematic` | Find the Schematic company for a Stripe customer ID, or vice versa. |
### Company Overrides
| Tool | Description |
|------|-------------|
| `list_company_overrides` | List overrides by company or by feature. |
| `set_company_override` | Set or update an override for a company on a specific feature. Supports boolean (`on`/`off`), numeric, and `unlimited` values. |
| `remove_company_override` | Remove an override so the company falls back to plan entitlements. |
### Plan Management
| Tool | Description |
|------|-------------|
| `list_plans` | List all plans. |
| `create_plan` | Create a new plan. |
| `add_entitlements_to_plan` | Add feature entitlements to a plan. Auto-detects feature type and sets appropriate value types. |
### Feature Management
| Tool | Description |
|------|-------------|
| `list_features` | List all features. |
| `create_feature` | Create a new feature flag. Supports boolean (on/off), event-based (metered), and trait-based types. Automatically creates an associated flag. |
### Flag Management
| Tool | Description |
|------|-------------|
| `list_flags` | List all flags with a targeting summary — for each flag: key, default value, linked feature, and whether it resolves to always-on, always-off, or targeted. Useful for auditing always-on flags (redundant to check in code) or unused flags (candidates for deletion). |
| `get_flag` | Get full targeting detail for one flag by key: default value, every rule (type, value, priority, condition count), last-checked time, and the always-on / always-off / targeted determination. |
## Example Prompts
Once configured, try asking your AI assistant:
- "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"
- "List all flags and tell me which ones are always-on"
- "Show me the targeting rules for the billing.credits flag"
## Development
```bash
# Install dependencies
yarn install
# Build
yarn build
# Run in development mode (auto-recompile on changes)
yarn dev
# Run tests
yarn test
```
## License
MIT