OneEntry MCP Server

MCP server for OneEntry SDK — gives AI assistants (Claude Code, Cursor, Windsurf) the rules, skills and SDK documentation needed to build OneEntry projects correctly.

Two ways to connect

| | npm package | Remote server | | ------------ | ------------------------------------ | -------------------------------------------- | | Install | npx -y @oneentry/mcp-server@latest | No install — just a URL | | Works in | Claude Code only | Claude Code, Cursor, Windsurf | | Requires | Nothing | OneEntry project token + URL | | Provides | Rules + Skills (context docs) | Rules + Skills + SDK documentation tools | | Best for | Quick local setup | Full AI-assisted development |

Option A — Remote server (recommended)

No installation. Works in Claude Code, Cursor, and Windsurf.

Provides everything the npm package does, plus 8 SDK documentation tools that the AI calls automatically to get module docs, code examples, and TypeScript types.

You will need:

• YOUR_TOKEN — API token from your OneEntry admin panel
• yourproject.oneentry.cloud — your OneEntry project domain

Claude Code — .mcp.json in project root

{
  "mcpServers": {
    "oneentry": {
      "type": "streamable-http",
      "url": "https://mcp-sdk-js.oneentry.cloud/mcp",
      "headers": {
        "X-OneEntry-Token": "YOUR_TOKEN",
        "X-OneEntry-URL": "https://yourproject.oneentry.cloud"
      }
    }
  }
}

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "oneentry": {
      "url": "https://mcp-sdk-js.oneentry.cloud/mcp",
      "headers": {
        "X-OneEntry-Token": "YOUR_TOKEN",
        "X-OneEntry-URL": "https://yourproject.oneentry.cloud"
      }
    }
  }
}

Windsurf

Add via Settings → MCP Servers:

URL:            https://mcp-sdk-js.oneentry.cloud/mcp?token=YOUR_TOKEN&url=https://yourproject.oneentry.cloud
Authentication: None

Alternative — custom headers (instead of query params)

URL:              https://mcp-sdk-js.oneentry.cloud/mcp
X-OneEntry-Token: YOUR_TOKEN
X-OneEntry-URL:   https://yourproject.oneentry.cloud

Option B — npm package (Claude Code only)

Serves rules and skills as readable context documents.

You can optionally add your OneEntry project URL and token via env — this lets the /inspect-api skill work without reading .env.local or asking you each time.

npx — no install:

{
  "mcpServers": {
    "oneentry": {
      "command": "npx",
      "args": ["-y", "@oneentry/mcp-server@latest"],
      "env": {
        "ONEENTRY_URL": "https://yourproject.oneentry.cloud",
        "ONEENTRY_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Local install (per project):

npm install --save-dev @oneentry/mcp-server

{
  "mcpServers": {
    "oneentry": {
      "command": "./node_modules/.bin/oneentry-mcp",
      "env": {
        "ONEENTRY_URL": "https://yourproject.oneentry.cloud",
        "ONEENTRY_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Global install:

npm install -g @oneentry/mcp-server

{
  "mcpServers": {
    "oneentry": {
      "command": "oneentry-mcp",
      "env": {
        "ONEENTRY_URL": "https://yourproject.oneentry.cloud",
        "ONEENTRY_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

env is optional. If omitted, /inspect-api reads from .env.local / .env, or asks you for the URL and token.

Available resources

Read them in Claude Code by typing @oneentry://rules/<name>:

| URI | Description | | ----------------------------------- | -------------------------------------- | | oneentry://claude-md | Full CLAUDE.md — main SDK instructions | | oneentry://rules/linting | Linting rules | | oneentry://rules/typescript | TypeScript rules | | oneentry://rules/nextjs-pages | Next.js pages, params as Promise | | oneentry://rules/attribute-values | attributeValues access by type | | oneentry://rules/attribute-sets | AttributeSets — schema vs values | | oneentry://rules/auth-provider | AuthProvider — auth/signUp rules | | oneentry://rules/tokens | Tokens & makeUserApi rules | | oneentry://rules/server-actions | Server Actions rules | | oneentry://rules/forms | Forms & FormsData rules | | oneentry://rules/orders | Orders & Payments rules | | oneentry://rules/localization | Localization, locale from params | | oneentry://rules/product-statuses | Product statuses rules |

Available tools

Called automatically by the AI when needed:

| Tool | Description | | -------------------- | ------------------------------------------------------------------ | | load-context | Reload the full OneEntry SDK instructions into context | | get-rule | Fetch a specific rule by name | | get-skill | Fetch a specific skill by name (supports $ARGUMENTS placeholder) | | get-project-config | Return project URL and token from .mcp.json env |

Available prompts (skills)

Invoke in Claude Code with /mcp__oneentry__<name>:

| Prompt | Description | | ---------------------------- | ----------------------------------------------------- | | oneentry-context | Reload full SDK context manually | | setup-nextjs | Initialize Next.js project | | setup-oneentry | Initialize SDK in a Next.js project | | inspect-api | Inspect real API markers and structure | | create-page | Create Next.js page with CMS content | | create-auth | Auth/registration form | | create-product-list | Product catalog with filters and pagination | | create-product-card | Single product card | | create-product-page | Single product page with gallery and related products | | create-cart-manager | Cart — Redux + persist | | create-favorites | Favorites — Redux + persist | | create-filter-panel | Filter panel with FilterContext | | create-checkout | Checkout form + payment | | create-orders-list | User orders list | | create-profile | User profile page | | create-form | Dynamic form from Forms API | | create-reviews | Reviews with hierarchy | | create-menu | Navigation menu with submenus | | create-search | Search bar with debounce | | create-locale-switcher | Locale switcher | | create-server-action | Next.js Server Action | | create-subscription-events | Price/availability subscription | | setup-playwright | Setup Playwright testing framework |