Skip to content
Domphy

Client Setup

@domphy/mcp is a stdio MCP server. Any MCP-capable editor or agent host can connect to it by adding an entry to its MCP config file.

Cursor

Create or edit .cursor/mcp.json at the repo root:

{
  "mcpServers": {
    "domphy": {
      "command": "npx",
      "args": ["-y", "@domphy/mcp"]
    }
  }
}

Reload the Cursor window after saving (Ctrl+Shift+P → "Developer: Reload Window").

VS Code

VS Code MCP support uses .vscode/mcp.json:

{
  "servers": {
    "domphy": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@domphy/mcp"]
    }
  }
}

Other MCP clients

Any MCP-compatible client that supports stdio servers can connect with this config shape:

{
  "mcpServers": {
    "domphy": {
      "command": "npx",
      "args": ["-y", "@domphy/mcp"]
    }
  }
}

Consult your client's documentation for the exact config file location.

Skipping the network on first run

npx downloads the package on first use. To avoid this delay, install globally first:

npm install -g @domphy/mcp

Then reference the binary directly:

{
  "mcpServers": {
    "domphy": {
      "command": "domphy-mcp",
      "args": []
    }
  }
}

Environment variables

DOMPHY_ORIGIN

The server fetches live data (patches, packages, rules, tones) from https://domphy.com by default. Override this to point at a staging or local preview deploy:

{
  "mcpServers": {
    "domphy": {
      "command": "npx",
      "args": ["-y", "@domphy/mcp"],
      "env": {
        "DOMPHY_ORIGIN": "http://localhost:5173"
      }
    }
  }
}

DOMPHY_APP_MANIFEST

Points the server at your app's block registry file. See App Blocks for the full workflow.

{
  "mcpServers": {
    "domphy": {
      "command": "npx",
      "args": ["-y", "@domphy/mcp"],
      "env": {
        "DOMPHY_APP_MANIFEST": "./apps/web/public/app-manifest.json"
      }
    }
  }
}

Verify the connection

Once connected, ask the agent: "List the Domphy packages." It should call domphy_list_packages and return a list like:

@domphy/core@0.18.2 — reactive core
@domphy/ui@0.18.14 — patches
@domphy/theme@0.18.2 — theme tokens
…

If the tool is not found, check that the config file is valid JSON and the correct path for your OS/editor, then restart the client.

Authentication

@domphy/mcp does not require any API keys or tokens. The server fetches public documentation from domphy.com and runs the doctor locally. No credentials are needed.