Log inSubmit server
Mdma logo

Mdma

by MobileReality

Provides MDMA specifications, prompts, package metadata, validation, and GitHub-hosted documentation through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Mdma

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mobilereality-mdma": {
      "command": "npx",
      "args": [
        "@mobile-reality/mdma-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 8 tools correctly (5d ago).

Overview

MobileReality/mdma MCP server gives AI assistants structured access to the MDMA specification, authoring prompts, npm package metadata, and documentation stored in GitHub. Its tools can generate and validate MDMA prompts, retrieve model-specific authoring variants, inspect available packages, and fetch documentation by branch, tag, or commit. Install it as an npm package with npx and connect it to an MCP client over stdio. Reach for it when an agent needs guidance or validation while creating interactive Markdown applications with mounted components.

Use cases

  • Retrieve the MDMA specification while generating an application
  • Build a system prompt from components, fields, steps, and business rules
  • Validate an MDMA authoring prompt against project conventions
  • Browse MDMA packages and installation examples
  • Fetch version-specific MDMA documentation from GitHub

Key features

  • Full MDMA specification retrieval
  • Model-specific authoring prompt variants
  • Custom system-prompt generation
  • Prompt validation
  • MDMA package and documentation catalogs
  • Git revision-aware document fetching

Tools8

What Mdma lets your agent do. Expand a tool for its parameters.

Verified live~1.5k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

21/24 checks healthy over the last 79d

What it can do

From the 8 tools this server returned when we ran it.

Read-only tools · 8
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age196 days
Maintainers4

Observed 2026-10-23 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · @mobile-reality/mdma-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars72Stargazers on the source repository.
npm downloads239Package downloads in the last 30 days.
Last commit5d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed8Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Mdma works

What MobileReality/mdma MCP server does

MobileReality/mdma MCP server exposes reference material and authoring utilities for MDMA, a format for interactive Markdown applications with mounted components. It gives an AI assistant access to the complete MDMA specification, including component types, JSON schemas, binding syntax, authoring rules, and external data-source references.

The server also covers the practical workflow around MDMA projects. Agents can retrieve named prompts for authoring, reviewing, and fixing MDMA content; inspect MDMA npm packages; and browse documentation files published in the project's public GitHub repository.

How it works

The package implements MCP tools that return structured or text-based MDMA resources to a connected assistant. get-spec returns the full specification, while get-prompt retrieves one of the named prompts. The authoring prompt can be selected by model variant, such as a variant identified for a particular model family. list-prompt-variants provides the available identifiers before the prompt is fetched.

For prompt generation, build-system-prompt accepts structured project information such as the domain, components, fields, workflow steps, and business rules. It can also receive a catalog of external data sources. These sources use rows, series, or options entries, and generated prompts describe references using { source, params }.

Documentation access is split into discovery and retrieval. list-docs returns the available files, and get-doc fetches the current file from the public GitHub repository. A branch, tag, or commit SHA can be supplied to retrieve a particular revision.

Setup and configuration

Install and launch the server through npm with:

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

This configuration starts @mobile-reality/mdma-mcp as a stdio MCP server. No environment variables are required by the documented setup. The package can be connected from clients that support standard MCP stdio servers, including Claude Desktop.

Tools and capabilities

  • get-spec: Retrieve the complete MDMA specification.
  • get-prompt: Fetch the author, reviewer, or fixer prompt, including an optional authoring variant.
  • list-prompt-variants: Discover available model-oriented authoring prompt IDs.
  • build-system-prompt: Create a custom MDMA system prompt from structured inputs and data-source definitions.
  • validate-prompt: Check a custom prompt against MDMA conventions.
  • list-packages: List MDMA npm packages with their purpose, installation command, example usage, and category.
  • list-docs: Browse documentation files available from the public repository.
  • get-doc: Fetch a documentation file, optionally at a selected Git revision.

Limitations and notes

The documentation tool reads from the public MobileReality/mdma GitHub repository, so retrieved content follows the selected repository revision. Model-optimized authoring prompts must first be selected from the identifiers returned by list-prompt-variants. The server focuses on MDMA reference, prompt, metadata, and documentation operations; it is not described as an execution environment for running MDMA applications.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Mdma

MobileReality/mdma is an MCP server that connects AI assistants to the MDMA specification, authoring prompts, npm package metadata, and GitHub-hosted documentation. Its main tools retrieve specs and prompts, build and validate custom prompts, list packages and docs, and fetch documentation at a selected branch, tag, or commit.

Install it by configuring your MCP client to run `npx @mobile-reality/mdma-mcp` over stdio. Add the package as the command with no additional arguments in the client’s MCP server configuration.

Yes, `build-system-prompt` creates a custom MDMA prompt from structured inputs such as domain, components, fields, workflow steps, and business rules. You can also pass a catalog of external `rows`, `series`, or `options` data sources.

Use `get-doc` with the documentation path and an optional `ref` value. The reference can be a GitHub branch, tag, or commit SHA, allowing the tool to retrieve documentation from a selected repository revision.

Yes, MobileReality/mdma can be configured in Claude Desktop as a stdio MCP server. Add an `mcpServers` entry that uses `npx` as the command and `@mobile-reality/mdma-mcp` as its argument.

Related MCP servers

All in Version Control All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMdma AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mobilereality-mdma?style=directory)](https://allmcps.com/mcp/mobilereality-mdma)
HTML Embed
<a href="https://allmcps.com/mcp/mobilereality-mdma"><img src="https://allmcps.com/api/badge/mobilereality-mdma?style=directory" alt="Mdma on AllMCPs" /></a>