@no-mess/mcp

MCP server for the no-mess headless CMS — schema introspection and content tools for AI coding agents.

What is this?

This package exposes your no-mess CMS data as Model Context Protocol tools. AI coding agents (Claude Code, Cursor, VS Code Copilot, etc.) can query your templates, fragments, entries, and Shopify data directly from the editor.

Install

npm install -g @no-mess/mcp
# or
bun add -g @no-mess/mcp

Available Tools

| Tool | Parameters | Description | |------|-----------|-------------| | get_schemas | — | List all template and fragment schemas with recursive field definitions | | get_schema | typeSlug | Get a single template or fragment schema by slug | | get_entries | typeSlug | Fetch all published entries of a template | | get_entry | typeSlug, entrySlug | Get a single entry by type and entry slug | | get_products | — | List all synced Shopify products | | get_product | handle | Get a Shopify product by handle | | get_collections | — | List all synced Shopify collections | | get_collection | handle | Get a Shopify collection by handle |

Configuration

| Variable | Required | Description | |----------|----------|-------------| | NO_MESS_API_KEY | Yes | Secret API key (starts with nm_). Publishable keys (nm_pub_) are rejected. | | NO_MESS_API_URL | No | Custom API URL (defaults to https://api.nomess.xyz) |

Schema results include kind, mode, route, and recursive field metadata, so agents can distinguish templates from fragments and understand nested objects, arrays, and fragment references.

IDE Setup

Claude Code

Add to your project's .claude/settings.json (or ~/.claude/settings.json for global):

{
  "mcpServers": {
    "no-mess": {
      "command": "npx",
      "args": ["-y", "@no-mess/mcp"],
      "env": {
        "NO_MESS_API_KEY": "nm_your_secret_key"
      }
    }
  }
}

VS Code / Cursor

Add to .vscode/mcp.json:

{
  "servers": {
    "no-mess": {
      "command": "npx",
      "args": ["-y", "@no-mess/mcp"],
      "env": {
        "NO_MESS_API_KEY": "nm_your_secret_key"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "no-mess": {
      "command": "npx",
      "args": ["-y", "@no-mess/mcp"],
      "env": {
        "NO_MESS_API_KEY": "nm_your_secret_key"
      }
    }
  }
}

Development

# Build
bun run build

License

MIT