MDMA

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.