@oneentry/mcp-server 1.0.0

package/README.md

@@ -0,0 +1,143 @@
+# OneEntry MCP Server
+
+MCP server for OneEntry SDK — serves rules and skills to Claude Code automatically from a remote server.
+
+Users don't need to copy any files. Connect once — always get the latest rules.
+
+## How it works
+
+| MCP concept | What it serves |
+|-------------|----------------|
+| **Resources** | Rules (`oneentry://rules/*`) + `CLAUDE.md` — readable context documents |
+| **Prompts** | Skills (`create-page`, `inspect-api`, etc.) — invocable by the user |
+
+Content is fetched from GitHub (configurable) and cached for 5 minutes.
+
+---
+
+## Quick start for users
+
+### Option 1 — npx (no install needed)
+
+Add to `~/.claude/claude_desktop_config.json` or `.mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "oneentry": {
+      "command": "npx",
+      "args": ["-y", "@oneentry/mcp-server"]
+    }
+  }
+}
+```
+
+### Option 2 — global install
+
+```bash
+npm install -g @oneentry/mcp-server
+```
+
+```json
+{
+  "mcpServers": {
+    "oneentry": {
+      "command": "oneentry-mcp"
+    }
+  }
+}
+```
+
+---
+
+## 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/forms` | Forms & FormsData rules |
+| `oneentry://rules/tokens` | Tokens & makeUserApi rules |
+| `oneentry://rules/attribute-values` | attributeValues access by type |
+| `oneentry://rules/auth-provider` | AuthProvider — auth/signUp rules |
+| `oneentry://rules/nextjs-pages` | Next.js pages, params as Promise |
+| `oneentry://rules/server-actions` | Server Actions rules |
+| `oneentry://rules/orders` | Orders & Payments rules |
+| `oneentry://rules/attribute-sets` | AttributeSets — schema vs values |
+| `oneentry://rules/localization` | Localization, locale from params |
+
+## Available prompts (skills)
+
+Invoke in Claude Code with `/skill-name`:
+
+| Prompt | Description |
+|--------|-------------|
+| `oneentry-context` | Load full SDK context at session start |
+| `setup-oneentry` | Initialize SDK in a Next.js project |
+| `create-page` | Create Next.js page with CMS content |
+| `inspect-api` | Inspect real API markers and structure |
+| `create-auth` | Auth/registration form |
+| `create-product-list` | Product catalog with filters and pagination |
+| `create-product-card` | Single product page |
+| `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 |
+
+---
+
+## For OneEntry team — updating content
+
+Rules and skills are fetched from the GitHub repo configured in `ONEENTRY_MCP_BASE_URL`.
+
+**Default URL:**
+```
+https://raw.githubusercontent.com/ONEENTRY-PLATFORM/oneentry-sdk-rules/main
+```
+
+Update rules in the repo — all users get the changes automatically within 5 minutes (cache TTL).
+
+**To point to a custom repo:**
+```json
+{
+  "mcpServers": {
+    "oneentry": {
+      "command": "npx",
+      "args": ["-y", "@oneentry/mcp-server"],
+      "env": {
+        "ONEENTRY_MCP_BASE_URL": "https://raw.githubusercontent.com/your-org/your-repo/main"
+      }
+    }
+  }
+}
+```
+
+---
+
+## Local development
+
+```bash
+cd mcp-server
+npm install
+npm run dev
+```
+
+To point at local files during development:
+```bash
+ONEENTRY_MCP_BASE_URL=file:///Users/you/claude-next npm run dev
+```
+
+Build for production:
+```bash
+npm run build
+```

package/dist/content.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Fetches content from a remote URL (GitHub raw or any HTTP server).
+ * Caches results for TTL_MS to avoid hammering the server.
+ *
+ * Configure the base URL via env var:
+ *   ONEENTRY_MCP_BASE_URL=https://raw.githubusercontent.com/your-org/your-repo/main
+ *
+ * Default points to the oneentry public repo.
+ */
+export declare function fetchContent(path: string): Promise<string>;
+export declare function clearCache(): void;

package/dist/content.js

@@ -0,0 +1,34 @@
+/**
+ * Fetches content from a remote URL (GitHub raw or any HTTP server).
+ * Caches results for TTL_MS to avoid hammering the server.
+ *
+ * Configure the base URL via env var:
+ *   ONEENTRY_MCP_BASE_URL=https://raw.githubusercontent.com/your-org/your-repo/main
+ *
+ * Default points to the oneentry public repo.
+ */
+const BASE_URL = process.env.ONEENTRY_MCP_BASE_URL ??
+    "https://raw.githubusercontent.com/ONEENTRY-PLATFORM/oneentry-sdk-rules/main";
+const TTL_MS = 5 * 60 * 1000; // 5 minutes
+const cache = new Map();
+export async function fetchContent(path) {
+    const cached = cache.get(path);
+    if (cached && cached.expires > Date.now()) {
+        return cached.text;
+    }
+    const url = `${BASE_URL}/${path}`;
+    const res = await fetch(url, {
+        headers: {
+            "User-Agent": "oneentry-mcp-server/1.0",
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch content (${res.status}): ${url}`);
+    }
+    const text = await res.text();
+    cache.set(path, { text, expires: Date.now() + TTL_MS });
+    return text;
+}
+export function clearCache() {
+    cache.clear();
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { fetchContent } from "./content.js";
+import { RULES, SKILLS } from "./registry.js";
+const CLAUDE_MD_PATH = "CLAUDE.md";
+// ---------------------------------------------------------------------------
+// Server
+// ---------------------------------------------------------------------------
+const server = new Server({ name: "oneentry-sdk", version: "1.0.0" }, {
+    capabilities: {
+        resources: {},
+        prompts: {},
+    },
+});
+// ---------------------------------------------------------------------------
+// Resources — rules + CLAUDE.md
+// ---------------------------------------------------------------------------
+server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+    resources: [
+        {
+            uri: "oneentry://claude-md",
+            name: "OneEntry SDK — Main Instructions (CLAUDE.md)",
+            description: "Full system prompt with OneEntry SDK rules, patterns, anti-hallucination guidelines and module reference",
+            mimeType: "text/markdown",
+        },
+        ...RULES.map((rule) => ({
+            uri: `oneentry://rules/${rule.name}`,
+            name: rule.displayName,
+            description: rule.description,
+            mimeType: "text/markdown",
+        })),
+    ],
+}));
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    // CLAUDE.md
+    if (uri === "oneentry://claude-md") {
+        const text = await fetchContent(CLAUDE_MD_PATH);
+        return { contents: [{ uri, mimeType: "text/markdown", text }] };
+    }
+    // Rules
+    if (uri.startsWith("oneentry://rules/")) {
+        const name = uri.replace("oneentry://rules/", "");
+        const rule = RULES.find((r) => r.name === name);
+        if (!rule) {
+            throw new Error(`Unknown rule: ${name}`);
+        }
+        const text = await fetchContent(rule.path);
+        return { contents: [{ uri, mimeType: "text/markdown", text }] };
+    }
+    throw new Error(`Unknown resource URI: ${uri}`);
+});
+// ---------------------------------------------------------------------------
+// Prompts — skills
+// ---------------------------------------------------------------------------
+server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+    prompts: [
+        // Special prompt: load full context from CLAUDE.md
+        {
+            name: "oneentry-context",
+            description: "Load full OneEntry SDK context — system instructions, rules and anti-hallucination guidelines. Use this at the start of a session.",
+            arguments: [],
+        },
+        // All skills
+        ...SKILLS.map((skill) => ({
+            name: skill.name,
+            description: skill.description,
+            arguments: skill.hasArguments
+                ? [
+                    {
+                        name: "arguments",
+                        description: skill.argumentDescription ?? "Optional arguments",
+                        required: false,
+                    },
+                ]
+                : [],
+        })),
+    ],
+}));
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    // Load full CLAUDE.md as system context
+    if (name === "oneentry-context") {
+        const text = await fetchContent(CLAUDE_MD_PATH);
+        return {
+            description: "OneEntry SDK — full system context loaded",
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `The following are the complete instructions and rules for working with OneEntry SDK. Apply them to all subsequent code generation:\n\n${text}`,
+                    },
+                },
+            ],
+        };
+    }
+    // Skills
+    const skill = SKILLS.find((s) => s.name === name);
+    if (!skill) {
+        throw new Error(`Unknown prompt: ${name}`);
+    }
+    let text = await fetchContent(skill.path);
+    // Replace $ARGUMENTS placeholder (used in inspect-api and create-page skills)
+    const userArguments = args?.["arguments"];
+    if (userArguments) {
+        text = text.replace(/\$ARGUMENTS/g, userArguments);
+    }
+    return {
+        description: skill.description,
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text,
+                },
+            },
+        ],
+    };
+});
+// ---------------------------------------------------------------------------
+// Start
+// ---------------------------------------------------------------------------
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr so it doesn't interfere with MCP stdio protocol
+    process.stderr.write("OneEntry MCP server running\n");
+}
+main().catch((err) => {
+    process.stderr.write(`Fatal error: ${err}\n`);
+    process.exit(1);
+});

package/dist/registry.d.ts

@@ -0,0 +1,15 @@
+export interface Rule {
+    name: string;
+    displayName: string;
+    description: string;
+    path: string;
+}
+export interface Skill {
+    name: string;
+    description: string;
+    path: string;
+    hasArguments?: boolean;
+    argumentDescription?: string;
+}
+export declare const RULES: Rule[];
+export declare const SKILLS: Skill[];

package/dist/registry.js

@@ -0,0 +1,157 @@
+export const RULES = [
+    {
+        name: "forms",
+        displayName: "Forms & FormsData",
+        description: "Rules for working with OneEntry Forms API — getFormByMarker, postFormsData, formData types by field type",
+        path: ".claude/rules/forms.md",
+    },
+    {
+        name: "tokens",
+        displayName: "Tokens & Auth",
+        description: "Rules for auth tokens — makeUserApi, refreshToken, race condition handling, getNewToken",
+        path: ".claude/rules/tokens.md",
+    },
+    {
+        name: "attribute-values",
+        displayName: "AttributeValues",
+        description: "How to access attributeValues by type — image, text, list, date, timeInterval, etc.",
+        path: ".claude/rules/attribute-values.md",
+    },
+    {
+        name: "auth-provider",
+        displayName: "AuthProvider",
+        description: "Rules for auth/signUp — IAuthPostBody structure, notificationData, server actions",
+        path: ".claude/rules/auth-provider.md",
+    },
+    {
+        name: "nextjs-pages",
+        displayName: "Next.js Pages",
+        description: "Rules for Next.js pages with OneEntry — params as Promise, pageUrl vs route, localizeInfos",
+        path: ".claude/rules/nextjs-pages.md",
+    },
+    {
+        name: "server-actions",
+        displayName: "Server Actions",
+        description: "Rules for Next.js Server Actions with OneEntry — getApi() vs makeUserApi(), which methods need SA",
+        path: ".claude/rules/server-actions.md",
+    },
+    {
+        name: "orders",
+        displayName: "Orders & Payments",
+        description: "Rules for Orders and Payments — getAllOrdersStorage structure, createOrder, createSession, paymentUrl",
+        path: ".claude/rules/orders.md",
+    },
+    {
+        name: "attribute-sets",
+        displayName: "AttributeSets",
+        description: "Rules for AttributesSets — schema vs values, listTitles, additionalFields, validators",
+        path: ".claude/rules/attribute-sets.md",
+    },
+    {
+        name: "localization",
+        displayName: "Localization",
+        description: "Rules for localization — locale from params, langCode, localizeInfos, useParams in client components",
+        path: ".claude/rules/localization.md",
+    },
+];
+export const SKILLS = [
+    {
+        name: "setup-oneentry",
+        description: "Initialize OneEntry SDK in a Next.js project — creates lib/oneentry.ts with singleton pattern, configures next.config.ts for images",
+        path: ".claude/skills/setup-oneentry/SKILL.md",
+    },
+    {
+        name: "create-page",
+        description: "Create a Next.js page with content from OneEntry CMS — getPageByUrl, getBlocksByPageUrl, localizeInfos",
+        path: ".claude/skills/create-page/SKILL.md",
+        hasArguments: true,
+        argumentDescription: "pageMarker — the pageUrl marker in OneEntry (e.g. 'home', 'about')",
+    },
+    {
+        name: "inspect-api",
+        description: "Read .env.local and execute curl requests to OneEntry API to get real markers, attributes and data structures before writing code",
+        path: ".claude/skills/inspect-api/SKILL.md",
+        hasArguments: true,
+        argumentDescription: "pages|menus|forms|products|product-statuses|auth-providers|all",
+    },
+    {
+        name: "create-auth",
+        description: "Create auth/registration form with OneEntry AuthProvider — Server Actions, dynamic fields from Forms API, token sync",
+        path: ".claude/skills/create-auth/SKILL.md",
+    },
+    {
+        name: "create-product-list",
+        description: "Create product catalog with URL-based filters, infinite scroll, Server Actions, FilterPanel and ProductGrid",
+        path: ".claude/skills/create-product-list/SKILL.md",
+    },
+    {
+        name: "create-product-card",
+        description: "Create a single product page with getProductById, attribute extraction, image gallery, price block, related products",
+        path: ".claude/skills/create-product-card/SKILL.md",
+    },
+    {
+        name: "create-cart-manager",
+        description: "Create cart manager — Redux slice + redux-persist, add/remove/quantity, StoreProvider",
+        path: ".claude/skills/create-cart-manager/SKILL.md",
+    },
+    {
+        name: "create-favorites",
+        description: "Create favorites list — Redux slice + persist, stores only product IDs, button and page with API data loading",
+        path: ".claude/skills/create-favorites/SKILL.md",
+    },
+    {
+        name: "create-filter-panel",
+        description: "Create filter panel — price, color, availability + FilterContext + Apply/Reset buttons",
+        path: ".claude/skills/create-filter-panel/SKILL.md",
+    },
+    {
+        name: "create-checkout",
+        description: "Create checkout form — fields from Forms API, timeInterval delivery slots, one makeUserApi for createOrder + createSession, redirect to payment",
+        path: ".claude/skills/create-checkout/SKILL.md",
+    },
+    {
+        name: "create-orders-list",
+        description: "Create user orders list — load via all storages, one makeUserApi, client pagination, token race condition protection",
+        path: ".claude/skills/create-orders-list/SKILL.md",
+    },
+    {
+        name: "create-profile",
+        description: "Create user profile page — Users API fields, data update, token race condition handling",
+        path: ".claude/skills/create-profile/SKILL.md",
+    },
+    {
+        name: "create-form",
+        description: "Create dynamic form with fields from OneEntry Forms API — all field types including spam (reCAPTCHA)",
+        path: ".claude/skills/create-form/SKILL.md",
+    },
+    {
+        name: "create-reviews",
+        description: "Create reviews with hierarchy — FormData, isNested, entityIdentifier, replayTo",
+        path: ".claude/skills/create-reviews/SKILL.md",
+    },
+    {
+        name: "create-menu",
+        description: "Create navigation menu with submenu support — hierarchy via parentId, URL normalization",
+        path: ".claude/skills/create-menu/SKILL.md",
+    },
+    {
+        name: "create-search",
+        description: "Create search bar — 300ms debounce, Server Action, dropdown results",
+        path: ".claude/skills/create-search/SKILL.md",
+    },
+    {
+        name: "create-locale-switcher",
+        description: "Create locale switcher — loads locales via getLocales(), builds links to current page with different locale segment",
+        path: ".claude/skills/create-locale-switcher/SKILL.md",
+    },
+    {
+        name: "create-server-action",
+        description: "Create Next.js Server Action for OneEntry — getApi() for public methods, makeUserApi() for user-authorized methods",
+        path: ".claude/skills/create-server-action/SKILL.md",
+    },
+    {
+        name: "create-subscription-events",
+        description: "Create product price/availability subscription — Events.subscribeByMarker / unsubscribeByMarker",
+        path: ".claude/skills/create-subscription-events/SKILL.md",
+    },
+];

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@oneentry/mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for OneEntry SDK — rules and skills for Claude Code",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "oneentry-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.1",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/content.ts

@@ -0,0 +1,48 @@
+/**
+ * Fetches content from a remote URL (GitHub raw or any HTTP server).
+ * Caches results for TTL_MS to avoid hammering the server.
+ *
+ * Configure the base URL via env var:
+ *   ONEENTRY_MCP_BASE_URL=https://raw.githubusercontent.com/your-org/your-repo/main
+ *
+ * Default points to the oneentry public repo.
+ */
+
+const BASE_URL =
+  process.env.ONEENTRY_MCP_BASE_URL ??
+  "https://raw.githubusercontent.com/ONEENTRY-PLATFORM/oneentry-sdk-rules/main";
+
+const TTL_MS = 5 * 60 * 1000; // 5 minutes
+
+interface CacheEntry {
+  text: string;
+  expires: number;
+}
+
+const cache = new Map<string, CacheEntry>();
+
+export async function fetchContent(path: string): Promise<string> {
+  const cached = cache.get(path);
+  if (cached && cached.expires > Date.now()) {
+    return cached.text;
+  }
+
+  const url = `${BASE_URL}/${path}`;
+  const res = await fetch(url, {
+    headers: {
+      "User-Agent": "oneentry-mcp-server/1.0",
+    },
+  });
+
+  if (!res.ok) {
+    throw new Error(`Failed to fetch content (${res.status}): ${url}`);
+  }
+
+  const text = await res.text();
+  cache.set(path, { text, expires: Date.now() + TTL_MS });
+  return text;
+}
+
+export function clearCache(): void {
+  cache.clear();
+}

package/src/index.ts

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  ListResourcesRequestSchema,
+  ReadResourceRequestSchema,
+  ListPromptsRequestSchema,
+  GetPromptRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import { fetchContent } from "./content.js";
+import { RULES, SKILLS } from "./registry.js";
+
+const CLAUDE_MD_PATH = "CLAUDE.md";
+
+// ---------------------------------------------------------------------------
+// Server
+// ---------------------------------------------------------------------------
+
+const server = new Server(
+  { name: "oneentry-sdk", version: "1.0.0" },
+  {
+    capabilities: {
+      resources: {},
+      prompts: {},
+    },
+  }
+);
+
+// ---------------------------------------------------------------------------
+// Resources — rules + CLAUDE.md
+// ---------------------------------------------------------------------------
+
+server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+  resources: [
+    {
+      uri: "oneentry://claude-md",
+      name: "OneEntry SDK — Main Instructions (CLAUDE.md)",
+      description:
+        "Full system prompt with OneEntry SDK rules, patterns, anti-hallucination guidelines and module reference",
+      mimeType: "text/markdown",
+    },
+    ...RULES.map((rule) => ({
+      uri: `oneentry://rules/${rule.name}`,
+      name: rule.displayName,
+      description: rule.description,
+      mimeType: "text/markdown",
+    })),
+  ],
+}));
+
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+  const { uri } = request.params;
+
+  // CLAUDE.md
+  if (uri === "oneentry://claude-md") {
+    const text = await fetchContent(CLAUDE_MD_PATH);
+    return { contents: [{ uri, mimeType: "text/markdown", text }] };
+  }
+
+  // Rules
+  if (uri.startsWith("oneentry://rules/")) {
+    const name = uri.replace("oneentry://rules/", "");
+    const rule = RULES.find((r) => r.name === name);
+    if (!rule) {
+      throw new Error(`Unknown rule: ${name}`);
+    }
+    const text = await fetchContent(rule.path);
+    return { contents: [{ uri, mimeType: "text/markdown", text }] };
+  }
+
+  throw new Error(`Unknown resource URI: ${uri}`);
+});
+
+// ---------------------------------------------------------------------------
+// Prompts — skills
+// ---------------------------------------------------------------------------
+
+server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+  prompts: [
+    // Special prompt: load full context from CLAUDE.md
+    {
+      name: "oneentry-context",
+      description:
+        "Load full OneEntry SDK context — system instructions, rules and anti-hallucination guidelines. Use this at the start of a session.",
+      arguments: [],
+    },
+    // All skills
+    ...SKILLS.map((skill) => ({
+      name: skill.name,
+      description: skill.description,
+      arguments: skill.hasArguments
+        ? [
+            {
+              name: "arguments",
+              description: skill.argumentDescription ?? "Optional arguments",
+              required: false,
+            },
+          ]
+        : [],
+    })),
+  ],
+}));
+
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  // Load full CLAUDE.md as system context
+  if (name === "oneentry-context") {
+    const text = await fetchContent(CLAUDE_MD_PATH);
+    return {
+      description: "OneEntry SDK — full system context loaded",
+      messages: [
+        {
+          role: "user" as const,
+          content: {
+            type: "text" as const,
+            text: `The following are the complete instructions and rules for working with OneEntry SDK. Apply them to all subsequent code generation:\n\n${text}`,
+          },
+        },
+      ],
+    };
+  }
+
+  // Skills
+  const skill = SKILLS.find((s) => s.name === name);
+  if (!skill) {
+    throw new Error(`Unknown prompt: ${name}`);
+  }
+
+  let text = await fetchContent(skill.path);
+
+  // Replace $ARGUMENTS placeholder (used in inspect-api and create-page skills)
+  const userArguments = args?.["arguments"];
+  if (userArguments) {
+    text = text.replace(/\$ARGUMENTS/g, userArguments);
+  }
+
+  return {
+    description: skill.description,
+    messages: [
+      {
+        role: "user" as const,
+        content: {
+          type: "text" as const,
+          text,
+        },
+      },
+    ],
+  };
+});
+
+// ---------------------------------------------------------------------------
+// Start
+// ---------------------------------------------------------------------------
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  // Log to stderr so it doesn't interfere with MCP stdio protocol
+  process.stderr.write("OneEntry MCP server running\n");
+}
+
+main().catch((err) => {
+  process.stderr.write(`Fatal error: ${err}\n`);
+  process.exit(1);
+});

package/src/registry.ts

@@ -0,0 +1,173 @@
+export interface Rule {
+  name: string;
+  displayName: string;
+  description: string;
+  path: string;
+}
+
+export interface Skill {
+  name: string;
+  description: string;
+  path: string;
+  hasArguments?: boolean;
+  argumentDescription?: string;
+}
+
+export const RULES: Rule[] = [
+  {
+    name: "forms",
+    displayName: "Forms & FormsData",
+    description: "Rules for working with OneEntry Forms API — getFormByMarker, postFormsData, formData types by field type",
+    path: ".claude/rules/forms.md",
+  },
+  {
+    name: "tokens",
+    displayName: "Tokens & Auth",
+    description: "Rules for auth tokens — makeUserApi, refreshToken, race condition handling, getNewToken",
+    path: ".claude/rules/tokens.md",
+  },
+  {
+    name: "attribute-values",
+    displayName: "AttributeValues",
+    description: "How to access attributeValues by type — image, text, list, date, timeInterval, etc.",
+    path: ".claude/rules/attribute-values.md",
+  },
+  {
+    name: "auth-provider",
+    displayName: "AuthProvider",
+    description: "Rules for auth/signUp — IAuthPostBody structure, notificationData, server actions",
+    path: ".claude/rules/auth-provider.md",
+  },
+  {
+    name: "nextjs-pages",
+    displayName: "Next.js Pages",
+    description: "Rules for Next.js pages with OneEntry — params as Promise, pageUrl vs route, localizeInfos",
+    path: ".claude/rules/nextjs-pages.md",
+  },
+  {
+    name: "server-actions",
+    displayName: "Server Actions",
+    description: "Rules for Next.js Server Actions with OneEntry — getApi() vs makeUserApi(), which methods need SA",
+    path: ".claude/rules/server-actions.md",
+  },
+  {
+    name: "orders",
+    displayName: "Orders & Payments",
+    description: "Rules for Orders and Payments — getAllOrdersStorage structure, createOrder, createSession, paymentUrl",
+    path: ".claude/rules/orders.md",
+  },
+  {
+    name: "attribute-sets",
+    displayName: "AttributeSets",
+    description: "Rules for AttributesSets — schema vs values, listTitles, additionalFields, validators",
+    path: ".claude/rules/attribute-sets.md",
+  },
+  {
+    name: "localization",
+    displayName: "Localization",
+    description: "Rules for localization — locale from params, langCode, localizeInfos, useParams in client components",
+    path: ".claude/rules/localization.md",
+  },
+];
+
+export const SKILLS: Skill[] = [
+  {
+    name: "setup-oneentry",
+    description: "Initialize OneEntry SDK in a Next.js project — creates lib/oneentry.ts with singleton pattern, configures next.config.ts for images",
+    path: ".claude/skills/setup-oneentry/SKILL.md",
+  },
+  {
+    name: "create-page",
+    description: "Create a Next.js page with content from OneEntry CMS — getPageByUrl, getBlocksByPageUrl, localizeInfos",
+    path: ".claude/skills/create-page/SKILL.md",
+    hasArguments: true,
+    argumentDescription: "pageMarker — the pageUrl marker in OneEntry (e.g. 'home', 'about')",
+  },
+  {
+    name: "inspect-api",
+    description: "Read .env.local and execute curl requests to OneEntry API to get real markers, attributes and data structures before writing code",
+    path: ".claude/skills/inspect-api/SKILL.md",
+    hasArguments: true,
+    argumentDescription: "pages|menus|forms|products|product-statuses|auth-providers|all",
+  },
+  {
+    name: "create-auth",
+    description: "Create auth/registration form with OneEntry AuthProvider — Server Actions, dynamic fields from Forms API, token sync",
+    path: ".claude/skills/create-auth/SKILL.md",
+  },
+  {
+    name: "create-product-list",
+    description: "Create product catalog with URL-based filters, infinite scroll, Server Actions, FilterPanel and ProductGrid",
+    path: ".claude/skills/create-product-list/SKILL.md",
+  },
+  {
+    name: "create-product-card",
+    description: "Create a single product page with getProductById, attribute extraction, image gallery, price block, related products",
+    path: ".claude/skills/create-product-card/SKILL.md",
+  },
+  {
+    name: "create-cart-manager",
+    description: "Create cart manager — Redux slice + redux-persist, add/remove/quantity, StoreProvider",
+    path: ".claude/skills/create-cart-manager/SKILL.md",
+  },
+  {
+    name: "create-favorites",
+    description: "Create favorites list — Redux slice + persist, stores only product IDs, button and page with API data loading",
+    path: ".claude/skills/create-favorites/SKILL.md",
+  },
+  {
+    name: "create-filter-panel",
+    description: "Create filter panel — price, color, availability + FilterContext + Apply/Reset buttons",
+    path: ".claude/skills/create-filter-panel/SKILL.md",
+  },
+  {
+    name: "create-checkout",
+    description: "Create checkout form — fields from Forms API, timeInterval delivery slots, one makeUserApi for createOrder + createSession, redirect to payment",
+    path: ".claude/skills/create-checkout/SKILL.md",
+  },
+  {
+    name: "create-orders-list",
+    description: "Create user orders list — load via all storages, one makeUserApi, client pagination, token race condition protection",
+    path: ".claude/skills/create-orders-list/SKILL.md",
+  },
+  {
+    name: "create-profile",
+    description: "Create user profile page — Users API fields, data update, token race condition handling",
+    path: ".claude/skills/create-profile/SKILL.md",
+  },
+  {
+    name: "create-form",
+    description: "Create dynamic form with fields from OneEntry Forms API — all field types including spam (reCAPTCHA)",
+    path: ".claude/skills/create-form/SKILL.md",
+  },
+  {
+    name: "create-reviews",
+    description: "Create reviews with hierarchy — FormData, isNested, entityIdentifier, replayTo",
+    path: ".claude/skills/create-reviews/SKILL.md",
+  },
+  {
+    name: "create-menu",
+    description: "Create navigation menu with submenu support — hierarchy via parentId, URL normalization",
+    path: ".claude/skills/create-menu/SKILL.md",
+  },
+  {
+    name: "create-search",
+    description: "Create search bar — 300ms debounce, Server Action, dropdown results",
+    path: ".claude/skills/create-search/SKILL.md",
+  },
+  {
+    name: "create-locale-switcher",
+    description: "Create locale switcher — loads locales via getLocales(), builds links to current page with different locale segment",
+    path: ".claude/skills/create-locale-switcher/SKILL.md",
+  },
+  {
+    name: "create-server-action",
+    description: "Create Next.js Server Action for OneEntry — getApi() for public methods, makeUserApi() for user-authorized methods",
+    path: ".claude/skills/create-server-action/SKILL.md",
+  },
+  {
+    name: "create-subscription-events",
+    description: "Create product price/availability subscription — Events.subscribeByMarker / unsubscribeByMarker",
+    path: ".claude/skills/create-subscription-events/SKILL.md",
+  },
+];

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "types": ["node"]
+  },
+  "include": ["src"]
+}