Substratum.Mcp 2.60.0

Substratum MCP Server

Model Context Protocol server for the Substratum .NET framework. Lets AI assistants like Claude, Cursor, and Windsurf scaffold, analyse, and upgrade your Substratum projects with expert-level fluency.

Install

dotnet tool install -g Substratum.Mcp

The tool command is dotnet-sub-mcp.

Register with your AI client

Claude Code / Claude Desktop

{
  "mcpServers": {
    "substratum": {
      "command": "dotnet-sub-mcp"
    }
  }
}

Cursor / Windsurf / other MCP clients

Same config — any MCP client that supports stdio servers works. When the client exposes a workspace root, the server picks it up automatically; most tool calls then don't need a projectPath argument.

What it gives your AI

13 tools

Every tool is annotated (ReadOnly, Destructive, Idempotent, OpenWorld) so clients render correct permission UIs, and every structured tool declares an outputSchema.

6 resources

Static content — loaded once by the client, referenced as often as the AI needs without burning tool round-trips:

Resource template parameters use AllowedValues completions — your AI client can tab-complete valid skill/guide names.

5 prompts

Orchestrated multi-step workflows — the AI follows a single prompt instead of planning 10+ tool calls itself:

MCP capabilities used

This server takes full advantage of modern MCP features — not just basic tools/call:

• Tool annotations — clients render correct permission UIs
• Structured outputs — typed records with declared outputSchema
• Progress notifications — build, upgrade, db, scaffold stream progress
• Cancellation tokens — every async tool cancels cleanly
• Roots — projectPath falls back to the client's workspace root
• Sampling — design_validate can ask the LLM for qualitative feedback
• Elicitation — destructive ops (db action=update, upgrade dryRun=false) ask the user to confirm
• Completions — skill/guide resource templates offer tab-complete

What you can ask your AI to do

• "Scaffold a Products feature with CRUD endpoints" — uses the new_feature prompt end-to-end
• "Add a permission for exporting invoices and gate the endpoint" — scaffold kind=permission + endpoint update
• "Analyse my project and tell me what's missing" — Roslyn scan flags missing FKs, indexes, naming violations
• "Upgrade this project to the latest Substratum" — upgrade_project prompt: analyse → dry-run → confirm → apply → build
• "Design a backend for a multi-tenant SaaS" — design_for_domain prompt produces a validated JSON design

About Substratum

Substratum is an opinionated, production-grade application framework built on ASP.NET Core. Authentication, authorization, database, caching, logging, OpenAPI docs, cloud storage, push notifications, real-time events, and background jobs — all pre-wired and configured via appsettings.json.

• Main package: Substratum
• Source generator: Substratum.Generator
• CLI tool: Substratum.Tools (dotnet-sub)
• Repository & full docs: github.com/aljaff94/Substratum

License

MIT — do anything you want with it.