MCP.Market

Schematic MCP server

by SchematicHQ·io.github.SchematicHQ/schematic-mcp·v0.4.0·2 stars

Manage companies, plans, features, and billing through SchematicHQ

C62/100grade C
What users say
No reviews yet
Be the first
Safety scan
C62/100

full report

Adoption
Growing

2 stars238 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • add_entitlements_to_addon

    Add 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_plan

    Add 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_usage

    Check 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_addon

    Count how many companies have a specific add-on

  • count_companies_on_plan

    Count how many companies are on a specific plan

  • create_addonwrite action

    Create a new add-on

  • create_companywrite action

    Create (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 action

    Create 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 action

    Create a new plan

  • create_plan_with_billingwrite action

    Create 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_limit

    Find 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_entitlements

    Get all features/entitlements included in an add-on. Shows what features an add-on grants and their values.

  • get_company

    Get 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_plan

    Get the plan that a company is currently on

  • get_company_trial_info

    Check if a company is on a trial and when it ends

  • get_feature_usage

    Get 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_flag

    Get 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_entitlements

    Get 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_schematic

    Find the Schematic company for a Stripe customer ID, or vice versa. Returns both IDs and links to both platforms.

  • list_addons

    List all add-ons in your Schematic account

  • list_company_overrides

    List 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_features

    List all features in your Schematic account

  • list_flags

    List 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_plans

    List all plans in your Schematic account. Does not include add-ons.

  • remove_company_overridewrite action

    Remove 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_override

    Set 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

1 high
  • 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 archivedmaint.archived
Overall 62/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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

  1. 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)

  1. Install the package from npm:
npm i @schematichq/schematic-mcp
  1. 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-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/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:

  1. Environment variable (recommended): SCHEMATICAPIKEY
  2. 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.