MCP Protocol@solidnumber/mcp v1.0.1

Connect your AI editor to a
real business in 30 seconds

608 MCP tools across 36 categories. One config file. Claude Code, Cursor, or Windsurf connects directly to CRM, payments, calendar, KB, and AI agents — no API to learn.

608

MCP Tools

Get your API key

Sign up for free developer access. You get an API key, a sandbox company, and full access to all 608 MCP tools across 36 categories.

Create Free Developer Account Already have an account

Or use the CLI

npx @solidnumber/cli auth login

Connect your editor

Add one config file. The server boots via npx @solidnumber/mcp — no install step, always the latest version, stdio transport. The SOLID_API_KEYenv var is your Bearer token; every request is tenant-scoped to the company that key belongs to.

Claude Code / Claude Desktop

{
  "mcpServers": {
    "solidnumber": {
      "command": "npx",
      "args": ["-y", "@solidnumber/mcp"],
      "env": {
        "SOLID_API_KEY": "sk_solid_your_key_here",
        "SOLID_API_URL": "https://api.solidnumber.com"
      }
    }
  }
}

Cursor / Windsurf

{
  "mcpServers": {
    "solidnumber": {
      "command": "npx",
      "args": ["-y", "@solidnumber/mcp"],
      "env": {
        "SOLID_API_KEY": "sk_solid_your_key_here",
        "SOLID_API_URL": "https://api.solidnumber.com"
      }
    }
  }
}

Local development (clone the repo)

{
  "mcpServers": {
    "solidnumber": {
      "command": "node",
      "args": ["/path/to/solid-mcp-server/src/comprehensive-index.js"],
      "env": {
        "SOLID_API_KEY": "sk_solid_your_key_here",
        "SOLID_API_URL": "https://api.solidnumber.com"
      }
    }
  }
}

Production HTTP transport

A hosted HTTP endpoint (api.solidnumber.com/mcp) is on the roadmap for multi-tenant managed MCP. For now, use stdio via npx — it runs in your editor's process, keeps your key local, and has identical tool coverage.

Start building

Just talk to your editor. The AI already understands every tool.

"Show me all contacts who booked this week"

solid_calendar_list→Returns merged Google + local calendar events

"Add a premium detailing service for $299"

solid_vibe → vibe_analyze → vibe_apply→Creates service, updates KB, trains agents

"Connect this company to their Stripe account"

solid_integration_connect→Connects Stripe with test/live key management

"What does the onboarding flow look like?"

docs_search_owners_manual→Searches 1,222 docs, returns relevant architecture docs

"Generate a 5-page website for a plumber"

vibe_generate_website→Builds pages from industry KB template

608 Tools, 6 Categories

Business Customization

solid_schemaDiscover database entities and fields

solid_capabilitiesList what you can customize

solid_field_addAdd custom fields to contacts, orders, etc.

solid_workflow_createBuild automation workflows

solid_template_updateUpdate email/SMS/PDF templates

solid_integration_connectConnect Stripe, QuickBooks, Google, Zapier

How It Works

Your Editor

Claude Code, Cursor, or Windsurf. You type natural language. The AI picks the right MCP tool automatically.

MCP Server

608 tools across 36 categories, 1,615 REST endpoints. Bearer-token auth, tenant-scoped by API key, stdio transport.

Business Data

511 tables (429 with RLS), 116 AI agents, CRM, payments, calendar, KB. Every tool operates on real data with full tenant isolation.

Who Uses This

Freelance Developers

Build client businesses from your editor. Pull data, push changes, manage AI agents — all without leaving VS Code.

Free developer access

Agencies

Manage 50 client businesses from one MCP connection. Switch companies, deploy changes, monitor health — all from your terminal.

Multi-company support built in

AI Agent Builders

Build custom AI agents that use MCP tools to execute real business operations. Not a wrapper — closed-loop execution.

AI agents as reference implementations

Configuration

The server resolves config from three sources, in order: environment variables (set in your editor's MCP config), a local .env file (for cloned-repo dev), then sensible defaults. Env vars always win — safest for keeping secrets out of disk.

Variable	Purpose	Default
`SOLID_API_KEY`	Bearer token (scope-limited API key)	`required`
`SOLID_API_URL`	Backend base URL	`https://api.solidnumber.com`
`BACKEND_URL`	Alias for SOLID_API_URL (legacy)	`—`
`API_KEY`	Alias for SOLID_API_KEY (legacy)	`—`

Get your API key via the CLI

The fastest way to get a scoped key without leaving the terminal — reuse it in your MCP config:

npm i -g @solidnumber/cli
solid auth login
solid auth token create -n "MCP" -s kb:read,pages:write,agents:converse
# Paste the sk_solid_... value into SOLID_API_KEY in your MCP config

Troubleshooting

\u203AEditor says "MCP server failed to start"

Check that Node 18+ is installed (node -v). The npx command downloads on first run — first launch can take ~20s. Check your editor's MCP logs for the real error.

\u203ATools list is empty

Your SOLID_API_KEY is probably missing or malformed. The server still boots and advertises all 608 tools, but every call returns 401. Verify with: echo $SOLID_API_KEY — should start with sk_solid_.

\u203AAll tools return 403 "Forbidden"

Your token has scopes that don't cover this operation. Create a broader key: solid auth token create -s kb:read,kb:write,pages:write,agents:converse,vibe:execute. See the CLI docs for the full 26-scope list.

\u203ACalls to api.solidnumber.com time out

Bump the HTTP timeout by setting SOLID_TIMEOUT_MS=60000 in your MCP config env block. Run solid doctor from the terminal to confirm the backend is reachable from your machine.

\u203AWant to point at a local backend

Set SOLID_API_URL=http://localhost:8090 in your MCP config. Handy for contributing to solid-mcp-server or testing against a sandbox.

\u203AFirst-run npx is slow

After the first launch, npx caches the package. Subsequent boots are <200ms. To pin a version: "args": ["-y", "@solidnumber/mcp@1.0.1"].

Security

Tenant Isolation

Every API call scoped to your company_id. RLS on 429 of 511 tables. You can never see another company's data.

Scoped API Keys

26 granular scopes. Give a key only kb:read access, or full write. Keys are SHA-256 hashed at rest.

Vibe Safety

Every vibe action is reversible. No deletions, always rollback. Preview before apply.

Audit Trail

Every MCP tool call logged with who, what, when, and which company. Full accountability.

Your AI editor already speaks MCP

One config file. 608 tools across 36 categories. Free developer access. Start managing real businesses from your terminal.

Get Free API Key CLI Documentation AI Agents REST API Reference

Connect your AI editor to areal business in 30 seconds