mdma — Claude Code MCP server: what it does, how to install
An MCP server that hands your coding assistant the MDMA spec, ready-made authoring prompts, package info and repo docs.
claude mcp add mdma -- npx -y @mobile-reality/mdma-mcpWhat mdma does
It speaks MCP over stdio. Ask for the full MDMA spec with get-spec, and the assistant gets component types, JSON schemas, binding syntax, authoring rules and how external data sources are declared. list-packages returns the npm packages with their install commands, while list-docs and get-doc reach into the public repository for documentation files.
Three prompts ship by name: mdma-author, mdma-reviewer, mdma-fixer. The author prompt has model-tuned versions, so run list-prompt-variants for the ids and pass one as variantId. Writing your own is the other path: build-system-prompt takes a domain, components, fields, steps and business rules, plus an optional catalog of data sources you then reference as { source, params }. validate-prompt checks the result against MDMA conventions.
The server starts as npx -y @mobile-reality/mdma-mcp, so npx has to be on the machine. get-doc fetches from raw.githubusercontent.com/MobileReality/mdma and accepts an optional ref for a branch, tag or SHA. Block that host and the doc tools return nothing.
What it helps with
- pull the MDMA spec into the chat instead of switching to the browser
- generate a prompt tuned for a specific model via
variantId - assemble a system prompt from your own domain and component list
- lint a hand-written prompt against MDMA conventions
- fetch a doc from a branch, tag or commit SHA
Example prompts for the agent
- Call
get-specand walk me through the component schemas - Build a system prompt for a ticketing domain with
build-system-prompt, then check it withvalidate-prompt - Which author prompt variants exist? Start with
list-prompt-variants, then fetch one by id
How to install mdma
Platform CLI
claude mcp add mdma -- npx -y @mobile-reality/mdma-mcpPlatform CLI
codex mcp add mcp -- npx -y @mobile-reality/mdma-mcpConfig file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@mobile-reality/mdma-mcp"
]
}
}
}Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mobile-reality/mdma-mcp"
]
}
}
}Platform CLI
gemini mcp add mcp npx -y @mobile-reality/mdma-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mdma
How do I install mdma in Claude Code?
Run claude mcp add mdma -- npx -y @mobile-reality/mdma-mcp. The server then runs over stdio from the npm package.
What does mdma do?
It serves the MDMA spec, authoring and review prompts, package metadata and repository docs to the assistant, so you stop pasting that material into the chat by hand.
Does get-doc work without internet access?
No. It reads files from raw.githubusercontent.com/MobileReality/mdma, and the optional ref picks a branch, tag or SHA. The stdio server itself still starts without it.
