Mdma
Serves the MDMA spec, authoring prompts and docs to AI assistants
The repository was last updated 25 days ago and is published under MIT.
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- GitHub stars
- 77
- Last commit
- 25 days ago
- Language
- TypeScript
About Mdma
Mdma is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add mdma -- npx -y @mobile-reality/mdma-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mdma": {
"command": "npx",
"args": [
"-y",
"@mobile-reality/mdma-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mdma": {
"command": "npx",
"args": [
"-y",
"@mobile-reality/mdma-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mdma": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mobile-reality/mdma-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mdma": {
"command": "npx",
"args": [
"-y",
"@mobile-reality/mdma-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mdma": {
"command": "npx",
"args": [
"-y",
"@mobile-reality/mdma-mcp"
]
}
}
}Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- 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
What it does
- 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
Pricing
Open source
Prices change. Check mdma.software before you buy.
Mdma 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 to Mdma

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools