@assurly/mcp-server

A pre-deploy ship gate your AI agent calls before shipping. A local stdio MCP server that lets Cursor, Claude Code, and other MCP clients scan a Next.js + Supabase + Stripe + Vercel project and get one trusted verdict — blockers to fix, warnings to review — before the agent ships to production.

The agent that wrote your app can now check it: write code → assurly_scan_path → fix blockers → re-scan until READY TO SHIP.

Everything runs locally over stdio. Your source code is never uploaded — the tools mirror the assurly scan pipeline exactly (allRules + detector + Ship Gate report), so an agent scan matches the CLI on the same project.

Tools

| Tool | Description | | ---------------------- | ------------------------------------------ | | assurly_scan_path | Scan a local project directory | | assurly_scan_files | Scan in-memory { path, content }[] files | | assurly_explain_rule | Explain a rule id and how to fix it |

Install (npm)

Run the server directly with npx — no global install needed:

npx -y @assurly/mcp-server

Cursor (.cursor/mcp.json)

Add this server next to your other MCP entries:

{
  "mcpServers": {
    "assurly": {
      "command": "npx",
      "args": ["-y", "@assurly/mcp-server"]
    }
  }
}

After saving, restart Cursor (or reload MCP) and confirm the three assurly_* tools appear.

Claude Code

From your project directory:

claude mcp add assurly -- npx -y @assurly/mcp-server

Typical agent loop

1. Agent writes or edits code.
2. Call assurly_scan_path or assurly_scan_files.
3. Read blockers from the Ship Gate summary.
4. Call assurly_explain_rule for remediation hints.
5. Fix issues and re-scan until the verdict is READY TO SHIP.

Build from source (contributors)

If you are working on this repository directly, build and point your MCP client at the local output:

From the repo root:

npm run build -w assurly
npm run build -w @assurly/mcp-server

Run (stdio):

node packages/mcp-server/dist/index.js

Cursor (.cursor/mcp.json) with an absolute path to your clone:

{
  "mcpServers": {
    "assurly": {
      "command": "node",
      "args": ["/absolute/path/to/assurly/packages/mcp-server/dist/index.js"]
    }
  }
}

Claude Code:

claude mcp add assurly -- node /absolute/path/to/assurly/packages/mcp-server/dist/index.js

Replace /absolute/path/to/assurly with the path to this repository on your machine.