MCP.so
Sign In

MDMA

@MobileReality

Repository

About MDMA

Interactive documents from Markdown. Extends MD with forms, approvals, webhooks, and more — built for next gen apps

#mdma#markdown#generative-ui#llm#structured-output#ai-agents#forms#interactive-documents#react#model-context-protocol

Basic information

Category

Other

License

MIT

Runtime

node

Transports

stdio

Publisher

MobileReality

Submitted by

Mateusz Sadowski

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

8

Returns the full MDMA specification: component types, schemas (as JSON Schema), binding syntax, and authoring rules

Returns a named MDMA prompt (mdma-author, mdma-reviewer, or mdma-fixer). For mdma-author, pass an optional variantId (e.g. "google/gemini-2.5-pro") to get the model-optimised variant — use list-prompt-variants to see all available ids.

Returns all available MDMA_AUTHOR prompt variants with their id, label, and description. Pass the id to get-prompt as variantId to retrieve the model-optimised prompt.

Generates a custom MDMA prompt from structured input (domain, components, fields, steps). Returns only the custom prompt part — use buildSystemPrompt({ customPrompt }) in code to combine it with the base MDMA spec.

Validates a custom prompt against MDMA conventions. Returns warnings for anti-patterns and suggestions for improvements.

Returns all MDMA npm packages with their purpose, install command, usage example, and category

Returns the catalog of MDMA documentation files available for fetching from the public GitHub repo (path, title, description). Use this to discover what docs you can pass to get-doc.

Fetches the latest version of an MDMA documentation file from the public GitHub repo (raw.githubusercontent.com/MobileReality/mdma) and returns its contents as text. Allowed paths: any entry from list-docs, plus any *.md file under "docs/" or "blueprints/". Defaults to the "main" branch.

Overview

What is MDMA?

MDMA is an MCP (Model Context Protocol) server that exposes the MDMA specification, authoring prompts, package metadata, and live GitHub documentation to AI assistants. It is built and published by MobileReality as the npm package @mobile-reality/mdma-mcp.

How to use MDMA?

Add the following to your MCP client configuration:

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

No further explicit usage instructions are provided.

Key features of MDMA

  • Provides full MDMA specification via get-spec tool.
  • Returns authoring, reviewing, and fixing prompts via get-prompt.
  • Lists available prompt variants for model-optimised prompts.
  • Generates custom MDMA prompts from structured input.
  • Validates custom prompts against MDMA conventions.
  • Lists MDMA npm packages with install commands and examples.
  • Retrieves up-to-date documentation from the public GitHub repository.

Use cases of MDMA

  • AI-assisted authoring of MDMA component specifications.
  • Reviewing and fixing existing MDMA prompts with model-optimised variants.
  • Fetching the latest MDMA docs directly into an AI conversation.
  • Building and validating custom prompts for specialised MDMA workflows.
  • Exploring MDMA npm packages and their usage from an AI assistant.

FAQ from MDMA

What tools does the MDMA MCP server offer?

It offers eight tools: get-spec, get-prompt, list-prompt-variants, build-system-prompt, validate-prompt, list-packages, list-docs, and get-doc.

Why does MCP Registry publish fail with 403 Forbidden?

The registry is case‑sensitive; the mcpName and server.json name must exactly match the GitHub organisation’s canonical capitalisation (MobileReality, not mobilereality). If the error mentions a missing org, verify your GitHub membership is public.

How do I build a Desktop Extension (.mcpb) bundle?

Build from a clean npm‑installed directory to avoid missing transitive dependencies. Do not run mcpb pack directly from the repository because pnpm’s virtual store strips .pnpm/ folders.

Where does the server fetch documentation from?

The get-doc tool fetches the latest version of a document from raw.githubusercontent.com/MobileReality/mdma, optionally at a specific branch, tag, or SHA.

What are the runtime requirements?

The server runs via npx and therefore requires Node.js and npm. No other runtime dependencies are documented.

Comments

More Other MCP servers

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

MCP Go 🚀

mark3labs

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

8.9K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K