Macroforge MCP Server

Lists all Macroforge documentation sections.

Returns sections with:

• title: Section name

• use_cases: When this doc is useful (comma-separated keywords)

• path: File path

• category: Category name

WORKFLOW:

1. Call list-sections FIRST for any Macroforge-related task

2. Analyze use_cases to find relevant sections

3. Call get-documentation with ALL relevant section names

Example use_cases: "setup, install", "serialization, json", "validation, email"

Retrieves full documentation content for Macroforge sections.

Supports flexible search by:

• Title (e.g., "Debug", "Vite Plugin")

• ID (e.g., "debug", "vite-plugin")

• Partial matches

Can accept a single section name or an array of sections. After calling list-sections, analyze the use_cases and fetch ALL relevant sections at once.

Validates TypeScript code with @derive decorators using Macroforge's native validation.

Returns structured JSON diagnostics with:

• level: error | warning | info

• message: What's wrong

• location: Line and column number (when available)

• help: Suggested fix (when available)

• notes: Additional context (when available)

• summary: Count of errors, warnings, and info messages

This tool MUST be used before sending Macroforge code to the user. If require_another_tool_call_after_fixing is true, fix the issues and validate again.

Detects:

• Invalid/unknown macro names

• Malformed @derive decorators

• @serde validator issues (email, url, length, etc.)

• Macro expansion failures

• Syntax errors in generated code

Expands Macroforge macros in TypeScript code and returns the transformed result.

Shows:

• The fully expanded TypeScript code with all generated methods

• Any diagnostics (errors, warnings, info) with line/column locations

• Help text for fixing issues (when available)

Useful for:

• Seeing what code the macros generate

• Understanding how @derive decorators transform your classes

• Debugging macro expansion issues

Get documentation for Macroforge macros and decorators.

Returns information about:

• Macro descriptions (e.g., Debug, Serialize, Clone)

• Decorator documentation (e.g., @serde, @debug field decorators)

• Available macro options and configuration

Use without parameters to get the full manifest of all available macros and decorators. Use with a name parameter to get info for a specific macro or decorator.