{
  "markdown": "# Schematic MCP Server\n\n> [!WARNING]\n> **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.\n\nAn [MCP](https://modelcontextprotocol.io/) server that connects AI assistants to [Schematic](https://schematichq.com) -- the platform for managing billing, plans, features, and entitlements.\n\nUse 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.\n\n## Quick Start\n\n### Prerequisites\n\n1. **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.\n\n### Installation\n\n#### Option 1: Using Claude CLI (Recommended)\n\n1. Install the package from npm:\n   ```bash\n   npm i @schematichq/schematic-mcp\n   ```\n\n2. Add the MCP server to Claude:\n   ```bash\n   claude mcp add --transport stdio --scope project schematic --env SCHEMATIC_API_KEY=your-secret-api-key-here -- npx @schematichq/schematic-mcp\n   ```\n\n   Replace `your-secret-api-key-here` with your actual Schematic API key.\n\n#### Option 2: Manual Configuration\n\n##### Claude Desktop / Claude Code\n\nAdd to your Claude config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"schematic\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@schematichq/schematic-mcp\"],\n      \"env\": {\n        \"SCHEMATIC_API_KEY\": \"your-secret-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to your Cursor MCP config (Settings > MCP Servers, or edit the file directly):\n\n- **macOS**: `~/.cursor/mcp.json`\n- **Linux**: `~/.cursor/mcp.json`\n- **Windows**: `%USERPROFILE%\\.cursor\\mcp.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"schematic\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@schematichq/schematic-mcp\"],\n      \"env\": {\n        \"SCHEMATIC_API_KEY\": \"your-secret-api-key-here\"\n      }\n    }\n  }\n}\n```\n\nAfter adding the config, restart Cursor for the server to be picked up.\n\n## Configuration\n\nThe server needs a Schematic **secret** API key (not the publishable key). It checks two sources in order:\n\n1. **Environment variable** (recommended): `SCHEMATIC_API_KEY`\n2. **Config file** (fallback): `~/.schematic-mcp/config.json`\n\n```json\n{\n  \"apiKey\": \"your-secret-api-key-here\"\n}\n```\n\nYou can find your secret API key in the [Schematic dashboard](https://app.schematichq.com).\n\n### Custom API base URL (optional)\n\nBy default the server targets the production Schematic API. To point it at a local or non-production API, set `SCHEMATIC_API_URL`:\n\n```json\n{\n  \"command\": \"npx\",\n  \"args\": [\"@schematichq/schematic-mcp\"],\n  \"env\": {\n    \"SCHEMATIC_API_KEY\": \"your-secret-api-key-here\",\n    \"SCHEMATIC_API_URL\": \"http://localhost:8080\"\n  }\n}\n```\n\nWhen unset, the SDK's production default is used.\n\n## Tools\n\n### Company Lookup\n\n| Tool | Description |\n|------|-------------|\n| `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. |\n| `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. |\n| `get_company_plan` | Get the plan a company is currently on. |\n| `get_company_trial_info` | Check if a company is on a trial and when it ends. |\n| `count_companies_on_plan` | Count how many companies are on a specific plan. |\n| `link_stripe_to_schematic` | Find the Schematic company for a Stripe customer ID, or vice versa. |\n\n### Company Overrides\n\n| Tool | Description |\n|------|-------------|\n| `list_company_overrides` | List overrides by company or by feature. |\n| `set_company_override` | Set or update an override for a company on a specific feature. Supports boolean (`on`/`off`), numeric, and `unlimited` values. |\n| `remove_company_override` | Remove an override so the company falls back to plan entitlements. |\n\n### Plan Management\n\n| Tool | Description |\n|------|-------------|\n| `list_plans` | List all plans. |\n| `create_plan` | Create a new plan. |\n| `add_entitlements_to_plan` | Add feature entitlements to a plan. Auto-detects feature type and sets appropriate value types. |\n\n### Feature Management\n\n| Tool | Description |\n|------|-------------|\n| `list_features` | List all features. |\n| `create_feature` | Create a new feature flag. Supports boolean (on/off), event-based (metered), and trait-based types. Automatically creates an associated flag. |\n\n### Flag Management\n\n| Tool | Description |\n|------|-------------|\n| `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). |\n| `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. |\n\n## Example Prompts\n\nOnce configured, try asking your AI assistant:\n\n- \"What plan is Acme Corp on?\"\n- \"List all my plans and their features\"\n- \"Create a boolean feature called 'Advanced Analytics'\"\n- \"Set an override for Acme Corp to have unlimited API calls\"\n- \"How many companies are on the Pro plan?\"\n- \"Find the Schematic company linked to Stripe customer cus_abc123\"\n- \"List all flags and tell me which ones are always-on\"\n- \"Show me the targeting rules for the billing.credits flag\"\n\n## Development\n\n```bash\n# Install dependencies\nyarn install\n\n# Build\nyarn build\n\n# Run in development mode (auto-recompile on changes)\nyarn dev\n\n# Run tests\nyarn test\n```\n\n## License\n\nMIT\n",
  "bytes": 6172,
  "sha": "d789f9008e027350db61ff0d3d320071baecc1dc5009ae43d455486010e9bb8c",
  "repo_slug": "schematichq/schematic-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_schematichq_schematic_mcp_cc1c1cfb/readme"
}