@lynkow/mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,6 @@
+Copyright (c) 2026 Lynkow. All rights reserved.
+
+This software is proprietary and confidential. Unauthorized copying, modification,
+distribution, or use of this software, via any medium, is strictly prohibited.
+
+The software is provided "as is", without warranty of any kind, express or implied.

package/README.md

@@ -0,0 +1,104 @@
+# @lynkow/mcp-server
+
+Model Context Protocol (MCP) server for [Lynkow](https://lynkow.com) — manage your headless CMS website with AI assistants like Claude, ChatGPT, Cursor, and more.
+
+## Quick Start
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "lynkow": {
+      "command": "npx",
+      "args": ["@lynkow/mcp-server"],
+      "env": {
+        "LYNKOW_API_TOKEN": "your-mcp-token"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+Create `.mcp.json` at your project root:
+
+```json
+{
+  "mcpServers": {
+    "lynkow": {
+      "command": "npx",
+      "args": ["@lynkow/mcp-server"],
+      "env": {
+        "LYNKOW_API_TOKEN": "your-mcp-token"
+      }
+    }
+  }
+}
+```
+
+## Configuration
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `LYNKOW_API_TOKEN` | Yes | - | API token with MCP preset |
+| `LYNKOW_API_URL` | No | `https://api.lynkow.com` | Custom API URL (self-hosted only) |
+| `LYNKOW_LOCALE` | No | `fr` | Default locale |
+| `LYNKOW_DEBUG` | No | `false` | Enable debug logs on stderr |
+
+## 121 Tools Available
+
+| Category | Tools | Examples |
+|----------|-------|---------|
+| Contents | 13 | list, create, update, publish, archive, duplicate, bulk operations, revisions |
+| Site Blocks | 10 | pages & global blocks: CRUD, publish, revisions, restore |
+| Categories | 7 | CRUD, tree hierarchy, copy to locale |
+| Tags | 7 | CRUD, translations, copy to locale |
+| Variables | 7 | site-wide key-value pairs, translations |
+| Media | 12 | files & folders: upload by URL, move, references |
+| Forms | 10 | CRUD, submissions, status management, CSV export |
+| Reviews | 10 | CRUD, bulk moderation, stats, settings |
+| SEO | 6 | settings, sitemap JSON, IndexNow |
+| Sitemap | 7 | entries CRUD, preview, import/export |
+| Redirects | 8 | CRUD, bulk delete, import/export |
+| Analytics | 9 | overview, pages, sources, realtime, engagement, funnels, export |
+| Settings | 10 | site info, language, spam, cookie consent, notifications |
+| Translations | 5 | cross-resource translation status & copy |
+
+## Example Prompts
+
+Once connected, ask your AI assistant:
+
+- "List all published articles on my site"
+- "Create a blog post titled 'Getting Started' and publish it"
+- "Enable English and Spanish on my site"
+- "Show me traffic stats for the last 30 days"
+- "Archive all draft articles older than 6 months"
+
+## Multi-site
+
+Each token is tied to one site. Configure multiple servers for multiple sites:
+
+```json
+{
+  "mcpServers": {
+    "lynkow-blog": {
+      "command": "npx",
+      "args": ["@lynkow/mcp-server"],
+      "env": { "LYNKOW_API_TOKEN": "token-blog" }
+    },
+    "lynkow-shop": {
+      "command": "npx",
+      "args": ["@lynkow/mcp-server"],
+      "env": { "LYNKOW_API_TOKEN": "token-shop" }
+    }
+  }
+}
+```
+
+## License
+
+Proprietary - Copyright (c) 2026 Lynkow. All rights reserved.

package/bin/lynkow-mcp.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import { startServer } from '../dist/index.js'
+
+startServer().catch((error) => {
+  console.error('[lynkow-mcp] Fatal error:', error.message)
+  process.exit(1)
+})

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+
+declare const configSchema: z.ZodObject<{
+    apiUrl: z.ZodDefault<z.ZodString>;
+    apiToken: z.ZodString;
+    locale: z.ZodDefault<z.ZodString>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+    debug: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    apiUrl: string;
+    apiToken: string;
+    locale: string;
+    timeout: number;
+    debug: boolean;
+}, {
+    apiToken: string;
+    apiUrl?: string | undefined;
+    locale?: string | undefined;
+    timeout?: number | undefined;
+    debug?: boolean | undefined;
+}>;
+type LynkowConfig = z.infer<typeof configSchema>;
+
+declare class LynkowApiClient {
+    private baseUrl;
+    private token;
+    private timeout;
+    private debug;
+    constructor(config: LynkowConfig);
+    get<T>(path: string, params?: Record<string, unknown>): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    put<T>(path: string, body?: unknown): Promise<T>;
+    delete<T>(path: string, params?: Record<string, unknown>): Promise<T>;
+    private request;
+}
+
+declare function startServer(): Promise<void>;
+
+export { LynkowApiClient, type LynkowConfig, startServer };