Mdma

What MobileReality/mdma MCP server does

MobileReality/mdma MCP server provides reference material and authoring utilities for MDMA, an interactive Markdown format that represents mounted application components in fenced mdma blocks. The server is intended for AI assistants that need to generate, inspect, or revise MDMA content rather than produce ordinary Markdown alone.

Its resources cover the MDMA specification, including component types, JSON schemas, binding syntax, and authoring rules. It also exposes named prompts for authoring, reviewing, and fixing MDMA output. Package metadata and documentation catalogs help an agent discover the surrounding MDMA packages and reference files.

How it works

The package communicates through MCP tools. An assistant can request the complete specification with get-spec, retrieve one of the named prompts with get-prompt, or enumerate available model-specific authoring variants with list-prompt-variants. The author prompt accepts an optional model identifier such as google/gemini-2.5-pro, allowing the server to return a corresponding optimized variant when available.

For prompt construction, build-system-prompt accepts structured information such as a domain, components, fields, steps, and business rules. validate-prompt checks a custom prompt against MDMA conventions and returns warnings, suggestions, and a constraint reference.

The documentation tools separate discovery from retrieval. list-docs returns available files with their paths, titles, and descriptions. get-doc then fetches a selected file from the public GitHub repository. Its optional ref parameter can target a branch, tag, or commit SHA; without one, it uses main.

Setup and configuration

Install the MobileReality/mdma MCP server with the package command below:

npx -y @mobile-reality/mdma-mcp

The supplied material does not specify required environment variables, API keys, client-specific configuration, or additional runtime settings. Documentation retrieval is described as reading from raw.githubusercontent.com, so the server's documentation source is public rather than a user-provided private repository.

Tools and capabilities

MobileReality/mdma MCP server exposes these capabilities:

• Return the full MDMA specification with get-spec.
• Retrieve author, reviewer, or fixer prompts with get-prompt.
• List model-specific MDMA_AUTHOR variants with list-prompt-variants.
• Generate a structured MDMA system prompt with build-system-prompt.
• Check a custom prompt and report warnings or suggestions with validate-prompt.
• List MDMA packages, their purposes, install commands, and usage examples with list-packages.
• Browse available documentation metadata with list-docs.
• Fetch a current documentation file, optionally pinned to a Git reference, with get-doc.

Limitations and notes

The server supplies MDMA knowledge and prompt tooling; the provided material does not describe tools for rendering MDMA interfaces, running generated applications, or executing package install commands on the user's behalf. Prompt evaluation results in the repository are model- and scenario-specific. The documentation also notes that smaller models may be more likely to lose context or drift during longer multi-turn flows, while certain listed model variants have documented behavior issues in particular evaluations.

get-doc retrieves documentation from the public MDMA GitHub repository and defaults to the main reference. Use its ref option when reproducibility requires a branch, tag, or commit-specific document version.