# Mdma

> Mdma is an open-source MCP server for developer tools. Serves the MDMA spec, authoring prompts and docs to AI assistants. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://mdma.software
- **Repository:** https://github.com/mobilereality/mdma/tree/HEAD/packages/mcp
- **GitHub stars:** 77
- **License:** MIT
- **MCP Registry name:** io.github.MobileReality/mdma
- **Categories:** developer tools
- **Listing updated:** 2026-11-17

## About

MDMA is a Markdown extension in which an LLM writes interactive components, such as forms, tables and approval gates, inside fenced mdma blocks that a renderer turns into live UI. This server gives an assistant what it needs to write and check those blocks: the full spec, ready-made prompts and the project's documentation.

The prompt tools return named prompts for authoring, reviewing and fixing, with model-specific variants for the author prompt. A builder generates a custom prompt from a domain, components, fields, steps and business rules, optionally including a catalogue of external data sources, and another tool validates a custom prompt against MDMA conventions. Documentation is fetched live from the public GitHub repository, with an optional branch, tag or SHA.

It runs over stdio from the npm package @mobile-reality/mdma-mcp and needs no environment variables. The MDMA framework itself renders in React, Vue and React Native and is built by Mobile Reality.

## Features

- **Full spec access:** Returns component types, JSON schemas, binding syntax and authoring rules.
- **Named prompts:** Author, reviewer and fixer prompts, with model-optimised author variants.
- **Prompt builder:** Generates a custom prompt from domain, components, fields, steps and rules.
- **Prompt validation:** Checks a custom prompt against MDMA conventions.
- **Package catalogue:** Lists MDMA npm packages with install commands and usage examples.
- **Live docs:** Fetches the latest docs from GitHub at a branch, tag or SHA.

## Good for

- Have an assistant write a valid MDMA form or approval gate
- Review or repair an MDMA document with the fixer prompt
- Generate a system prompt for a domain-specific MDMA agent
- Look up which MDMA package renders for Vue or React Native
- Read the latest MDMA docs without leaving the editor

## Install

### Claude Code (Terminal)

```sh
claude mcp add mdma -- npx -y @mobile-reality/mdma-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mdma": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mobile-reality/mdma-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `get-spec`: Return the full MDMA specification
- `get-prompt`: Return a named MDMA prompt, optionally a model-optimised variant
- `list-prompt-variants`: List available author prompt variants
- `build-system-prompt`: Generate a custom MDMA prompt from structured input
- `validate-prompt`: Validate a custom prompt against MDMA conventions
- `list-packages`: List MDMA npm packages with install commands
- `list-docs`: List documentation files in the public repository
- `get-doc`: Fetch the latest version of a doc from GitHub

## FAQ

### How do I install it?

Add an mcpServers entry that runs npx with @mobile-reality/mdma-mcp.

### Does it need configuration?

No environment variables are required.

### Where do the docs come from?

The get-doc tool fetches them from the public MobileReality/mdma GitHub repository.

### Which prompts are available?

mdma-author, mdma-reviewer and mdma-fixer.

### Is Mdma free?

Yes. Mdma is open source, so you can use and self-host it for free.

### How do I add Mdma to Claude Code?

Run this command in your terminal: claude mcp add mdma -- npx -y @mobile-reality/mdma-mcp

### What are the best alternatives to Mdma?

The closest alternatives to Mdma are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mdma
