👁 Image
Substratum.Mcp 2.60.0

👁 Substratum

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.

👁 MCP
👁 Substratum
👁 .NET 10
👁 MIT License

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.