npm package: @oneentry/mcp-server
Description: MCP server for OneEntry SDK — rules and skills for Claude Code
Latest version: 1.1.8

# 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

```json
{
  "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`

```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**:

```text
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)

```text
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:**

```json
{
  "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):**

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

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

**Global install:**

```bash
npm install -g @oneentry/mcp-server
```

```json
{
  "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                    |