Schematic MCP server
io.github.SchematicHQ/schematic-mcp·v0.4.0·2 starsManage companies, plans, features, and billing through SchematicHQ
2 stars238 downloads/wk
Reviews
Write oneNobody has reviewed Schematic yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Schematic tools (26, 6 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
add_entitlements_to_addonAdd entitlements to an add-on. The feature type will be automatically determined by querying the feature. For boolean features, defaults to 'on' if no value is provided. For event-based or trait-based features, a value (number or 'unlimited') is required.
add_entitlements_to_planAdd entitlements to a plan. The feature type will be automatically determined by querying the feature. For boolean features, defaults to 'on' if no value is provided. For event-based or trait-based features, a value (number or 'unlimited') is required.
check_companies_usageCheck feature usage for a specific list of companies and identify which are at or above a usage threshold for any metered feature. Useful for proactive health checks on known accounts. Results are grouped by feature and sorted by percent used.
count_companies_on_addonCount how many companies have a specific add-on
count_companies_on_planCount how many companies are on a specific plan
create_addonwrite actionCreate a new add-on
create_companywrite actionCreate (upsert) a company, identified by a key. Companies are looked up by one or more keys (e.g. an 'id' key) — see Key Management. Optionally set a display name and traits. If a company with the given key already exists, it is updated rather than duplicated.
create_featurewrite actionCreate a new feature flag. Boolean features are simple on/off switches - the most commonly used type, ideal for enabling/disabling functionality and basic plan differentiation. Event-based features are metered against user events and track usage that typically increases over time (e.g., API calls, reports generated, database queries). Trait-based features are based on information reported to Schem
create_planwrite actionCreate a new plan
create_plan_with_billingwrite actionCreate a new plan with a Stripe-linked billing product. This creates both the plan and its associated Stripe product and prices in one step. Prices are specified in dollars (e.g., 29.99 for $29.99/month). If no prices are provided, the plan is created with $0 pricing. Use this instead of create_plan when you want the plan to be connected to Stripe billing.
find_companies_near_limitFind companies at or above a usage threshold for a specific metered feature. Queries all companies for the given feature sorted by usage percentage (highest first), stopping as soon as usage drops below the threshold. If no featureId is provided, returns a list of metered features to choose from.
get_addon_entitlementsGet all features/entitlements included in an add-on. Shows what features an add-on grants and their values.
get_companyGet company information by ID, name, Stripe customer ID, or custom key. Returns company details including plan, trial status, and links. For custom key lookups, the user must provide both keyName and keyValue. Key names are configured in Schematic - see https://docs.schematichq.com/developer_resources/key_management for details.
get_company_planGet the plan that a company is currently on
get_company_trial_infoCheck if a company is on a trial and when it ends
get_feature_usageGet feature usage data for a company. Shows access status, usage vs allocation, and entitlement source for each feature. Optionally filter to a specific feature by providing featureId. If you only know the feature name, use list_features first to find the feature ID, then pass it here as featureId.
get_flagGet full targeting detail for a single flag by its key: default value, every rule (type, value, priority, condition count), last-checked time, and the computed always-on / always-off / targeted determination. Use this to inspect why a flag resolves the way it does.
get_plan_entitlementsGet all features/entitlements included in a plan. Shows what features a plan grants and their values (on/off for boolean, numeric limits for metered, unlimited).
link_stripe_to_schematicFind the Schematic company for a Stripe customer ID, or vice versa. Returns both IDs and links to both platforms.
list_addonsList all add-ons in your Schematic account
list_company_overridesList company overrides. Filter by company (to see all overrides for a company) or by feature (to see which companies have an override for a feature)
list_featuresList all features in your Schematic account
list_flagsList all feature flags in your Schematic account with their targeting summary. For each flag, reports its key, default value, linked feature (if any), and whether it currently resolves to always-on, always-off, or targeted (gated by rules). Use this to audit which flags are always-on (and so no longer need to be checked in code) or unused (and so can be deleted from Schematic).
list_plansList all plans in your Schematic account. Does not include add-ons.
remove_company_overridewrite actionRemove a company override for a feature/entitlement. This will delete the override and the company will fall back to their plan's entitlements.
set_company_overrideSet or update a company override for a feature/entitlement. REQUIRES a value parameter - always ask the user for the desired value before calling this tool. For boolean features: use 'on'/'off' or 'true'/'false'. For event-based or trait-based features: use a numeric value (e.g., '10', '100') or 'unlimited'.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancerepository archived0/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
Findings (1)
- highRepository is archived
maint.archived
How Schematic compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 62/100
- higher than 17% of 48,255 servers
- Tools
- 26
- the typical server has 7
- Tools that change things
- 23%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 2
- more than 75% of 28,688 servers
- Downloads a week
- 238
- more than 78% of 12,191 servers with a package
What its tools let an agent do: 17 read · 7 create · 1 change · 1 delete
Install Schematic in Claude Code, Cursor or VS Code
Runs npx -y @schematichq/schematic-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add schematic-mcp -- npx -y @schematichq/schematic-mcp
What the publisher says
From the Schematic repository's README, as published. We do not edit it. Read it on GitHub
Schematic MCP Server
[!WARNING]
Deprecated. Schematic now hosts an MCP server at https://api.schematichq.com/mcp — see the Schematic MCP documentation to connect. This local stdio server still works but no longer receives new tools or fixes.
An MCP server that connects AI assistants to Schematic -- 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
- Get your Schematic secret API key: Sign up for a Schematic account and get your secret API key from the Schematic dashboard. Note: use your secret API key, not the publishable key.
Installation
Option 1: Using Claude CLI (Recommended)
- Install the package from npm:
npm i @schematichq/schematic-mcp- Add the MCP server to Claude:
claude mcp add --transport stdio --scope project schematic --env SCHEMATIC_API_KEY=your-secret-api-key-here -- npx @schematichq/schematic-mcpReplace 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/claudedesktopconfig.json on macOS):
{
"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
{
"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:
- Environment variable (recommended): SCHEMATICAPIKEY
- Config file (fallback): ~/.schematic-mcp/config.json
{
"apiKey": "your-secret-api-key-here"
}You can find your secret API key in the Schematic dashboard.
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 SCHEMATICAPIURL:
{
"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
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Schematic: common questions
- Is Schematic MCP server safe?
- With care: it is graded C, so read the findings first (62/100). Read the Schematic safety report
- How do I install Schematic?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Schematic need an API key?
- Yes. The registry entry asks for
SCHEMATIC_API_KEY. - Is Schematic maintained?
- The last commit was 95 days ago (2026-07-31). The latest release is v0.4.0.
- How does Schematic compare with other MCP servers?
- safety score 62/100 (higher than 17% of 48,255 servers); tools 26 (the typical server has 7); tools that change things 23% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.