# MobileReality/mdma [Health: Active]

**Category:** 🔄 Version Control  
**Repository:** https://github.com/MobileReality/mdma/tree/main/packages/mcp  
**GitHub Stars:** 67  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mobilereality-mdma

## Description
MCP server for MDMA (interactive Markdown applications with mounted components). Exposes the MDMA spec, authoring prompts, package metadata, and live docs to AI assistants. Tools: get-spec, get-prompt, build-system-prompt, validate-prompt, list-packages, list-docs, get-doc. Install: npx @mobile-reality/mdma-mcp.

## Tools
Capabilities this server exposes over MCP:

- **get-spec** — Returns the full MDMA specification: component types, JSON schemas, binding syntax, and authoring rules
- **get-prompt** — Returns a named prompt (`mdma-author`, `mdma-reviewer`, or `mdma-fixer`). For `mdma-author`, accepts an optional `variantId` (e.g. `google/gemini-2.5-pro`) to return the model-optimised variant
- **list-prompt-variants** — Returns all available `MDMA_AUTHOR` prompt variants (id, label, description) — use the id with `get-prompt` to fetch the model-optimised prompt
- **build-system-prompt** — Generates a custom MDMA prompt from structured input (domain, components, fields, steps, business rules)
- **validate-prompt** — Validates a custom prompt against MDMA conventions — returns warnings, suggestions, and constraint reference
- **list-packages** — Returns all MDMA packages with purpose, install command, and usage example
- **list-docs** — Returns the catalog of MDMA documentation files (path, title, description) available for fetching from the public GitHub repo
- **get-doc** — Fetches the latest version of an MDMA documentation file from `raw.githubusercontent.com/MobileReality/mdma`. Supports optional `ref` (branch/tag/SHA, defaults to `main`)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mdma": {
    "command": "npx",
    "args": ["-y","@mobile-reality/mdma-cli"]
  }
}
```

## Documentation

## 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:

```bash
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.

_Full upstream README: https://allmcps.com/mcp/mobilereality-mdma/readme_