diff --git a/README.md b/README.md
index 823355d..c42d7c5 100644
--- a/README.md
+++ b/README.md
@@ -244,29 +244,99 @@ Details: [`docs/BOT_INTEGRATIONS.md`](docs/BOT_INTEGRATIONS.md)
 
 ## Packages
 
-| Package                     | Role                                                                                                                                      |
-| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
-| `@kiploks/engine-core`      | `analyze()`, `analyzeFromTrades()`, `analyzeFromWindows()`, `buildPathMonteCarloSimulation()`, `runProfessionalWfa()`                   |
-| `@kiploks/engine-contracts` | Versioned TypeScript types and constants. Import these for type safety in your own code.                                                  |
-| `@kiploks/engine-adapters`  | `csvToTrades` / streaming CSV to `Trade[]` (Freqtrade-shaped **JSON** is not parsed here; map to `Trade[]` in your layer).                |
-| `@kiploks/engine-cli`       | `npx kiploks analyze` - run analysis from JSON file, upload to cloud, run conformance tests                                              |
-| `@kiploks/engine-test-vectors` | Golden JSON fixtures for regression tests                                                                                             |
+| Package | Role |
+| --- | --- |
+| `@kiploks/engine-core` | `analyze()`, WFA, Monte Carlo, professional report |
+| `@kiploks/engine-contracts` | Versioned TypeScript types |
+| `@kiploks/engine-adapters` | CSV to `Trade[]` |
+| `@kiploks/engine-cli` | CLI + local UI orchestrator |
+| `@kiploks/engine-mcp` | MCP server for AI agents |
+| `@kiploks/engine-test-vectors` | Golden fixtures for regression tests |
+
+---
+
+## AI agents (MCP)
+
+Use `@kiploks/engine-mcp` so Cursor, Claude Desktop, or any MCP client can analyze backtests and fetch reports locally - no cloud account required.
+
+### 1. Add MCP server
+
+**Cursor** (Settings -> MCP or `.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "kiploks": {
+      "command": "npx",
+      "args": ["-y", "@kiploks/engine-mcp"],
+      "env": {
+        "KIPLOKS_ORCHESTRATOR_URL": "http://127.0.0.1:41731"
+      }
+    }
+  }
+}
+```
+
+From a repo checkout after `npm run build -w @kiploks/engine-mcp`:
+
+```json
+{
+  "mcpServers": {
+    "kiploks": {
+      "command": "node",
+      "args": ["packages/mcp-server/dist/index.js"]
+    }
+  }
+}
+```
+
+### 2. Analyze trades (no UI)
+
+Ask your agent to call `kiploks_analyze_trades` with a CSV or JSON `Trade[]` file.
+
+Or use CLI:
+
+```bash
+npx kiploks analyze-trades ./trades.json --json \
+  --in-sample-months 6 --out-of-sample-months 2 --step rolling
+```
+
+### 3. Freqtrade backtests (with UI)
+
+Start the local orchestrator:
+
+```bash
+npx -y @kiploks/engine-cli ui --no-open
+```
+
+Typical agent flow:
+
+1. `kiploks_orchestrator_status`
+2. `kiploks_register_freqtrade_path` with your Freqtrade install path
+3. `kiploks_bootstrap_integration`
+4. `kiploks_list_backtests`
+5. `kiploks_run_backtest_analysis` with `selected_artifact_keys`
+6. `kiploks_get_report` -> open `{orchestrator_url}/ui/#report={id}`
+
+If integration routes return `401`, set `KIPLOKS_ORCHESTRATOR_TOKEN` from `kiploks-freqtrade/kiploks.json` (`api_token`).
+
+Full guide: [`docs/AI_AGENTS.md`](docs/AI_AGENTS.md)
 
 ---
 
 ## Documentation
 
-| Topic                                      | Link                                                                                    |
-| ------------------------------------------ | --------------------------------------------------------------------------------------- |
-| **Which function to call** (start here)    | [`docs/ENTRYPOINTS.md`](docs/ENTRYPOINTS.md)                                            |
-| WFA methodology                            | [`docs/WFA_PROFESSIONAL.md`](docs/WFA_PROFESSIONAL.md)                                  |
-| Path Monte Carlo                           | [`docs/MONTE_CARLO_PATH.md`](docs/MONTE_CARLO_PATH.md)                                  |
-| Freqtrade / OctoBot (separate Python repos) | [`docs/BOT_INTEGRATIONS.md`](docs/BOT_INTEGRATIONS.md)                                 |
-| Reproducibility and hashes                 | [`docs/OPEN_CORE_REPRODUCIBILITY.md`](docs/OPEN_CORE_REPRODUCIBILITY.md)                  |
-| Error catalog                              | [`docs/ERROR_CATALOG.md`](docs/ERROR_CATALOG.md)                                        |
-| Local user guide                           | [`docs/OPEN_CORE_LOCAL_USER_GUIDE.md`](docs/OPEN_CORE_LOCAL_USER_GUIDE.md)               |
-| Examples and output explorer               | [`docs/examples/result-layout-demo.html`](docs/examples/result-layout-demo.html)        |
-| Research articles                          | [kiploks.com/research](https://kiploks.com/research)                                    |
+| Topic | Link |
+| --- | --- |
+| Which function to call | [`docs/ENTRYPOINTS.md`](docs/ENTRYPOINTS.md) |
+| AI agents and MCP | [`docs/AI_AGENTS.md`](docs/AI_AGENTS.md) |
+| WFA methodology | [`docs/WFA_PROFESSIONAL.md`](docs/WFA_PROFESSIONAL.md) |
+| Path Monte Carlo | [`docs/MONTE_CARLO_PATH.md`](docs/MONTE_CARLO_PATH.md) |
+| Freqtrade / OctoBot | [`docs/BOT_INTEGRATIONS.md`](docs/BOT_INTEGRATIONS.md) |
+| Reproducibility | [`docs/OPEN_CORE_REPRODUCIBILITY.md`](docs/OPEN_CORE_REPRODUCIBILITY.md) |
+| Error catalog | [`docs/ERROR_CATALOG.md`](docs/ERROR_CATALOG.md) |
+| Local user guide | [`docs/OPEN_CORE_LOCAL_USER_GUIDE.md`](docs/OPEN_CORE_LOCAL_USER_GUIDE.md) |
+| Examples | [`docs/examples/result-layout-demo.html`](docs/examples/result-layout-demo.html) |
 
 ---
 
diff --git a/docs/AI_AGENTS.md b/docs/AI_AGENTS.md
new file mode 100644
index 0000000..19073c7
--- /dev/null
+++ b/docs/AI_AGENTS.md
@@ -0,0 +1,133 @@
+# AI agents and MCP
+
+This guide explains how **other users** of the open-source Kiploks engine can let AI agents analyze backtests and fetch reports - without Kiploks cloud or private SaaS.
+
+## What an agent can do
+
+| Capability | Requires orchestrator? | MCP tool / CLI |
+|------------|------------------------|----------------|
+| WFA from trades CSV/JSON | No | `kiploks_analyze_trades` / `kiploks analyze-trades` |
+| Full report from integration JSON | No | `kiploks_analyze_integration_payload` |
+| List Freqtrade backtests on disk | Yes | `kiploks_list_backtests` |
+| Run Freqtrade bridge + WFA | Yes | `kiploks_run_backtest_analysis` |
+| Open report in local UI | Yes | `kiploks_get_report` -> `/ui/#report=<id>` |
+
+## Quick start for users
+
+### 1. Install engine CLI
+
+```bash
+npx -y @kiploks/engine-cli ui --no-open
+```
+
+Orchestrator listens on `http://127.0.0.1:41731` (or next free port). UI: `/ui/`.
+
+### 2. Add MCP server to your agent
+
+Package: `@kiploks/engine-mcp`
+
+**Cursor** (`.cursor/mcp.json` or Settings -> MCP):
+
+```json
+{
+  "mcpServers": {
+    "kiploks": {
+      "command": "npx",
+      "args": ["-y", "@kiploks/engine-mcp"]
+    }
+  }
+}
+```
+
+**Claude Desktop** (`claude_desktop_config.json`): same block under `mcpServers`.
+
+### 3. Analyze without Freqtrade (trades only)
+
+No orchestrator needed. Agent tool:
+
+- `kiploks_analyze_trades` with `input_path` pointing to CSV or JSON `Trade[]`
+
+Or CLI:
+
+```bash
+kiploks analyze-trades ./trades.json --json \
+  --in-sample-months 6 --out-of-sample-months 2 --step rolling
+```
+
+Sample output: `docs/examples/sample-output/wfa-from-trades.json`
+
+### 4. Freqtrade end-to-end flow
+
+Prerequisites on the user's machine:
+
+- Freqtrade install (path known to the user)
+- Docker (if using default `docker` integration mode)
+- Orchestrator running (`kiploks ui --no-open`)
+
+Agent steps:
+
+1. `kiploks_orchestrator_status` - confirm orchestrator is up
+2. `kiploks_register_freqtrade_path` - `path` = Freqtrade root
+3. `kiploks_bootstrap_integration` - clones `kiploks-freqtrade` into that repo
+4. `kiploks_list_backtests` - discover artifacts under `user_data/backtest_results`
+5. `kiploks_run_backtest_analysis` - pass `selected_artifact_keys` from step 4
+6. `kiploks_get_report` - full `TestResultData` JSON
+7. Share UI link: `{orchestrator_url}/ui/#report={report_id}`
+
+If integration upload needs Bearer auth, set in MCP env:
+
+```json
+"env": {
+  "KIPLOKS_ORCHESTRATOR_TOKEN": "<api_token from kiploks.json after bootstrap>"
+}
+```
+
+## Architecture
+
+```mermaid
+flowchart LR
+  Agent[AI Agent]
+  MCP[@kiploks/engine-mcp]
+  Core[@kiploks/engine-core]
+  Orch[kiploks ui orchestrator]
+  Bridge[kiploks-freqtrade run.py]
+  Agent --> MCP
+  MCP -->|trades / payload files| Core
+  MCP -->|HTTP| Orch
+  Orch --> Bridge
+  Bridge -->|POST /api/integration/results| Orch
+  Orch -->|reports| MCP
+```
+
+- **Standalone analysis** uses `@kiploks/engine-core` directly inside the MCP process.
+- **Freqtrade flow** uses the existing local orchestrator HTTP API (same as the web UI).
+- **Cloud upload** is optional: users can still use `kiploks upload --cloud` with `KIPLOKS_API_KEY`; MCP does not require it.
+
+## Programmatic API (no MCP)
+
+For custom agents or scripts, use the same building blocks:
+
+```ts
+import { analyzeFromTrades } from "@kiploks/engine-core";
+import { buildTestResultDataFromUnified } from "@kiploks/engine-core/server";
+import { mapPayloadToUnified } from "@kiploks/engine-core";
+```
+
+See [ENTRYPOINTS.md](./ENTRYPOINTS.md) for choosing the right entrypoint.
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---------|-----|
+| MCP cannot connect to orchestrator | Start `kiploks ui --no-open`; check `KIPLOKS_ORCHESTRATOR_URL` |
+| Empty backtest list | Register Freqtrade path; run a backtest; bootstrap bridge |
+| `401` on integration POST | Set `KIPLOKS_ORCHESTRATOR_TOKEN` from `kiploks.json` |
+| Docker upload `Connection refused` | From container use `host.docker.internal`, not `localhost` |
+| `analyze_trades` rejects JSON | Input must be `Trade[]` array, not raw Freqtrade export |
+
+## Related docs
+
+- [packages/mcp-server/README.md](../packages/mcp-server/README.md) - MCP tool reference
+- [BOT_INTEGRATIONS.md](./BOT_INTEGRATIONS.md) - Freqtrade/OctoBot bridges
+- [LOCAL_ORCHESTRATOR_UI_ARCHITECTURE.md](./LOCAL_ORCHESTRATOR_UI_ARCHITECTURE.md) - HTTP routes
+- [OPEN_CORE_LOCAL_USER_GUIDE.md](./OPEN_CORE_LOCAL_USER_GUIDE.md) - local user setup
diff --git a/docs/README.md b/docs/README.md
index fb1e5da..07f1eb4 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -22,6 +22,7 @@ Authoritative copies of engine-focused guides live **in this folder** so they sh
 | [`OSS_PUBLIC_REPO_SYNC.md`](OSS_PUBLIC_REPO_SYNC.md) | Repository layout, one `VERSION`, `sync-versions`, publish notes |
 | [`RELEASE_CHECKLIST.md`](../RELEASE_CHECKLIST.md) | Pre-release checks (tests, docs vs contracts) |
 | [`BOT_INTEGRATIONS.md`](BOT_INTEGRATIONS.md) | Freqtrade / OctoBot Python integrations (optional path without npm engine) |
+| [`AI_AGENTS.md`](AI_AGENTS.md) | MCP server and agent workflows for backtest analysis |
 | [`MONTE_CARLO_SIMULATION_IMPLEMENTATION.md`](MONTE_CARLO_SIMULATION_IMPLEMENTATION.md) | **Monte Carlo index** - path MC vs professional window bootstrap, links to guides |
 | [`MONTE_CARLO_PATH.md`](MONTE_CARLO_PATH.md) | **Path-based Monte Carlo (user guide)** - `buildPathMonteCarloSimulation`, API, limits, reproducibility |
 
diff --git a/package-lock.json b/package-lock.json
index 3c3dbeb..b179ea0 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "@kiploks/engine-monorepo",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@kiploks/engine-monorepo",
-      "version": "0.4.2",
+      "version": "0.4.3",
       "license": "Apache-2.0",
       "workspaces": [
         "packages/*"
@@ -890,6 +890,18 @@
         "node": "^20.19.0 || ^22.13.0 || >=24"
       }
     },
+    "node_modules/@hono/node-server": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/@hono/node-server/-/node-server-2.1.1.tgz",
+      "integrity": "sha512-ELuehkj5VCBdgEw9zs+ivkKwyzzUCSQuE96YmiPvn1ECBoZCczbFXJLeEGMTYjphP6gydh4pHMqEYPVMYUVgQg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      },
+      "peerDependencies": {
+        "hono": "^4"
+      }
+    },
     "node_modules/@humanfs/core": {
       "version": "0.19.1",
       "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.1.tgz",
@@ -1003,10 +1015,76 @@
       "resolved": "packages/core",
       "link": true
     },
+    "node_modules/@kiploks/engine-mcp": {
+      "resolved": "packages/mcp-server",
+      "link": true
+    },
     "node_modules/@kiploks/engine-test-vectors": {
       "resolved": "packages/test-vectors",
       "link": true
     },
+    "node_modules/@modelcontextprotocol/sdk": {
+      "version": "1.30.0",
+      "resolved": "https://registry.npmjs.org/@modelcontextprotocol/sdk/-/sdk-1.30.0.tgz",
+      "integrity": "sha512-xKd8OIzlqNzcqcNumGAa6g+PW2kjD5vrpcKOnfldAUPP3j7lnqMPwlTXQm8gF+UwH72z0lqaRbjr9hqGz0eITA==",
+      "license": "MIT",
+      "dependencies": {
+        "@hono/node-server": "^1.19.9 || ^2.0.5",
+        "ajv": "^8.17.1",
+        "ajv-formats": "^3.0.1",
+        "content-type": "^1.0.5",
+        "cors": "^2.8.5",
+        "cross-spawn": "^7.0.5",
+        "eventsource": "^3.0.2",
+        "eventsource-parser": "^3.0.0",
+        "express": "^5.2.1",
+        "express-rate-limit": "^8.2.1",
+        "hono": "^4.11.4",
+        "jose": "^6.1.3",
+        "json-schema-typed": "^8.0.2",
+        "pkce-challenge": "^5.0.0",
+        "raw-body": "^3.0.0",
+        "zod": "^3.25 || ^4.0",
+        "zod-to-json-schema": "^3.25.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "@cfworker/json-schema": "^4.1.1",
+        "zod": "^3.25 || ^4.0"
+      },
+      "peerDependenciesMeta": {
+        "@cfworker/json-schema": {
+          "optional": true
+        },
+        "zod": {
+          "optional": false
+        }
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk/node_modules/ajv": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk/node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "license": "MIT"
+    },
     "node_modules/@nodelib/fs.scandir": {
       "version": "2.1.5",
       "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
@@ -1891,6 +1969,19 @@
         "url": "https://opencollective.com/vitest"
       }
     },
+    "node_modules/accepts": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/accepts/-/accepts-2.0.0.tgz",
+      "integrity": "sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-types": "^3.0.0",
+        "negotiator": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
     "node_modules/acorn": {
       "version": "8.16.0",
       "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.16.0.tgz",
@@ -1931,6 +2022,45 @@
         "url": "https://github.com/sponsors/epoberezkin"
       }
     },
+    "node_modules/ajv-formats": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-3.0.1.tgz",
+      "integrity": "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==",
+      "license": "MIT",
+      "dependencies": {
+        "ajv": "^8.0.0"
+      },
+      "peerDependencies": {
+        "ajv": "^8.0.0"
+      },
+      "peerDependenciesMeta": {
+        "ajv": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/ajv-formats/node_modules/ajv": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
+      "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/ajv-formats/node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "license": "MIT"
+    },
     "node_modules/any-promise": {
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/any-promise/-/any-promise-1.3.0.tgz",
@@ -2060,6 +2190,43 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/body-parser": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-2.3.0.tgz",
+      "integrity": "sha512-2cGmJupaNgg+QUwVLAucDuWuoMZ6EX9iHDRswZ5lsNYEmwPaRknMPCLZz07yTzVq/83p4o/wzbDZbBrTvGGTIw==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "^3.1.2",
+        "content-type": "^2.0.0",
+        "debug": "^4.4.3",
+        "http-errors": "^2.0.1",
+        "iconv-lite": "^0.7.2",
+        "on-finished": "^2.4.1",
+        "qs": "^6.15.2",
+        "raw-body": "^3.0.2",
+        "type-is": "^2.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/body-parser/node_modules/content-type": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/content-type/-/content-type-2.1.0.tgz",
+      "integrity": "sha512-mj7UPXE0jaqaOsukNZRUEfEi2AcL7C/vwmwcHV0O97eO1E1pxBZuyjlZrx5seTaNBg1U6+o35wpa35Qfcc+7ag==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/brace-expansion": {
       "version": "5.0.5",
       "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.5.tgz",
@@ -2118,6 +2285,44 @@
         "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
       }
     },
+    "node_modules/bytes": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
+      "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/call-bound": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
+      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "get-intrinsic": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/camelcase-css": {
       "version": "2.0.1",
       "resolved": "https://registry.npmjs.org/camelcase-css/-/camelcase-css-2.0.1.tgz",
@@ -2202,17 +2407,73 @@
         "node": ">= 6"
       }
     },
+    "node_modules/content-disposition": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.1.0.tgz",
+      "integrity": "sha512-5jRCH9Z/+DRP7rkvY83B+yGIGX96OYdJmzngqnw2SBSxqCFPd0w2km3s5iawpGX8krnwSGmF0FW5Nhr0Hfai3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/content-type": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
+      "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
     "node_modules/convert-source-map": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
       "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==",
       "license": "MIT"
     },
+    "node_modules/cookie": {
+      "version": "0.7.2",
+      "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz",
+      "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/cookie-signature": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.2.2.tgz",
+      "integrity": "sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.6.0"
+      }
+    },
+    "node_modules/cors": {
+      "version": "2.8.6",
+      "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.6.tgz",
+      "integrity": "sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw==",
+      "license": "MIT",
+      "dependencies": {
+        "object-assign": "^4",
+        "vary": "^1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/cross-spawn": {
       "version": "7.0.6",
       "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
       "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "path-key": "^3.1.0",
@@ -2266,6 +2527,15 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/depd": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
+      "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
     "node_modules/didyoumean": {
       "version": "1.2.2",
       "resolved": "https://registry.npmjs.org/didyoumean/-/didyoumean-1.2.2.tgz",
@@ -2278,12 +2548,50 @@
       "integrity": "sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA==",
       "license": "MIT"
     },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/ee-first": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
+      "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
+      "license": "MIT"
+    },
     "node_modules/electron-to-chromium": {
       "version": "1.5.344",
       "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.344.tgz",
       "integrity": "sha512-4MxfbmNDm+KPh066EZy+eUnkcDPcZ35wNmOWzFuh/ijvHsve6kbLTLURy88uCNK5FbpN+yk2nQY6BYh1GEt+wg==",
       "license": "ISC"
     },
+    "node_modules/encodeurl": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
+      "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
     "node_modules/es-errors": {
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
@@ -2300,6 +2608,18 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.2.tgz",
+      "integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
     "node_modules/esbuild": {
       "version": "0.25.12",
       "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.12.tgz",
@@ -2350,6 +2670,12 @@
         "node": ">=6"
       }
     },
+    "node_modules/escape-html": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
+      "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
+      "license": "MIT"
+    },
     "node_modules/escape-string-regexp": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",
@@ -2525,6 +2851,36 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/etag": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
+      "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/eventsource": {
+      "version": "3.0.7",
+      "resolved": "https://registry.npmjs.org/eventsource/-/eventsource-3.0.7.tgz",
+      "integrity": "sha512-CRT1WTyuQoD771GW56XEZFQ/ZoSfWid1alKGDYMmkt2yl8UXrVR4pspqWNEcqKvVIzg6PAltWjxcSSPrboA4iA==",
+      "license": "MIT",
+      "dependencies": {
+        "eventsource-parser": "^3.0.1"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/eventsource-parser": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/eventsource-parser/-/eventsource-parser-3.1.1.tgz",
+      "integrity": "sha512-EKN1vKAMcZ8MlYMpaNuxN6R9yakzH6uajHcHVTqWJzvu5pWw9DyhbP35HH8MVBQ+dZjAfDxk+A8NiR9KWaXiyQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
     "node_modules/expect-type": {
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/expect-type/-/expect-type-1.3.0.tgz",
@@ -2535,11 +2891,72 @@
         "node": ">=12.0.0"
       }
     },
+    "node_modules/express": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/express/-/express-5.2.1.tgz",
+      "integrity": "sha512-hIS4idWWai69NezIdRt2xFVofaF4j+6INOpJlVOLDO8zXGpUVEVzIYk12UUi2JzjEzWL3IOAxcTubgz9Po0yXw==",
+      "license": "MIT",
+      "dependencies": {
+        "accepts": "^2.0.0",
+        "body-parser": "^2.2.1",
+        "content-disposition": "^1.0.0",
+        "content-type": "^1.0.5",
+        "cookie": "^0.7.1",
+        "cookie-signature": "^1.2.1",
+        "debug": "^4.4.0",
+        "depd": "^2.0.0",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "etag": "^1.8.1",
+        "finalhandler": "^2.1.0",
+        "fresh": "^2.0.0",
+        "http-errors": "^2.0.0",
+        "merge-descriptors": "^2.0.0",
+        "mime-types": "^3.0.0",
+        "on-finished": "^2.4.1",
+        "once": "^1.4.0",
+        "parseurl": "^1.3.3",
+        "proxy-addr": "^2.0.7",
+        "qs": "^6.14.0",
+        "range-parser": "^1.2.1",
+        "router": "^2.2.0",
+        "send": "^1.1.0",
+        "serve-static": "^2.2.0",
+        "statuses": "^2.0.1",
+        "type-is": "^2.0.1",
+        "vary": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/express-rate-limit": {
+      "version": "8.6.2",
+      "resolved": "https://registry.npmjs.org/express-rate-limit/-/express-rate-limit-8.6.2.tgz",
+      "integrity": "sha512-YH4ru+eOJxQABscKFfRCy9R7x9QFGdezclVMwwgFFndzS2Xnm0uo6B0ABZsLhcpeptGv2qvuJVWlQr9gQZoC3A==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.4.3",
+        "ip-address": "^10.2.0"
+      },
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/express-rate-limit"
+      },
+      "peerDependencies": {
+        "express": ">= 4.11"
+      }
+    },
     "node_modules/fast-deep-equal": {
       "version": "3.1.3",
       "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
       "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
-      "dev": true,
       "license": "MIT"
     },
     "node_modules/fast-glob": {
@@ -2584,6 +3001,22 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/fast-uri": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.5.tgz",
+      "integrity": "sha512-gHwA1O9LDIcKunMKhObS/HimwtehO1nPUECKAu5TpKgaO19fcWEl4bliWe1jWxVFvIXztJjjQ4L8XQ1EU9f7Jw==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
     "node_modules/fastq": {
       "version": "1.20.1",
       "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.1.tgz",
@@ -2635,6 +3068,27 @@
         "node": ">=8"
       }
     },
+    "node_modules/finalhandler": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.1.tgz",
+      "integrity": "sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.4.0",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "on-finished": "^2.4.1",
+        "parseurl": "^1.3.3",
+        "statuses": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 18.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/find-up": {
       "version": "5.0.0",
       "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz",
@@ -2673,6 +3127,15 @@
       "dev": true,
       "license": "ISC"
     },
+    "node_modules/forwarded": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
+      "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
     "node_modules/fraction.js": {
       "version": "5.3.4",
       "resolved": "https://registry.npmjs.org/fraction.js/-/fraction.js-5.3.4.tgz",
@@ -2686,6 +3149,15 @@
         "url": "https://github.com/sponsors/rawify"
       }
     },
+    "node_modules/fresh": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/fresh/-/fresh-2.0.0.tgz",
+      "integrity": "sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
     "node_modules/fsevents": {
       "version": "2.3.3",
       "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
@@ -2718,11 +3190,48 @@
         "node": ">=6.9.0"
       }
     },
-    "node_modules/glob-parent": {
-      "version": "6.0.2",
-      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz",
-      "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==",
-      "license": "ISC",
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "license": "MIT",
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/glob-parent": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz",
+      "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==",
+      "license": "ISC",
       "dependencies": {
         "is-glob": "^4.0.3"
       },
@@ -2730,6 +3239,18 @@
         "node": ">=10.13.0"
       }
     },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/has-flag": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
@@ -2740,6 +3261,18 @@
         "node": ">=8"
       }
     },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/hasown": {
       "version": "2.0.3",
       "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.3.tgz",
@@ -2752,6 +3285,15 @@
         "node": ">= 0.4"
       }
     },
+    "node_modules/hono": {
+      "version": "4.13.3",
+      "resolved": "https://registry.npmjs.org/hono/-/hono-4.13.3.tgz",
+      "integrity": "sha512-r8AO2mYHoLxSHkgafNeC/BXyb2vWRxD3jem4Ts+ptav8oTG5FIRifAjuJEmZI4bSvvc2ns0GxmIYiZnHqN3mMw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=16.9.0"
+      }
+    },
     "node_modules/html-escaper": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-2.0.2.tgz",
@@ -2759,6 +3301,42 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/http-errors": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz",
+      "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==",
+      "license": "MIT",
+      "dependencies": {
+        "depd": "~2.0.0",
+        "inherits": "~2.0.4",
+        "setprototypeof": "~1.2.0",
+        "statuses": "~2.0.2",
+        "toidentifier": "~1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/iconv-lite": {
+      "version": "0.7.3",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.7.3.tgz",
+      "integrity": "sha512-IKXpvIzjnC9XTAUbVBcMfGS0EPaIXtW6v+zr+RRp+hqULEpo0owZax6wyRwPOJbWbzjYspQwusTsfVr0ifh4uQ==",
+      "license": "MIT",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/ignore": {
       "version": "5.3.2",
       "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",
@@ -2779,6 +3357,30 @@
         "node": ">=0.8.19"
       }
     },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "license": "ISC"
+    },
+    "node_modules/ip-address": {
+      "version": "10.5.0",
+      "resolved": "https://registry.npmjs.org/ip-address/-/ip-address-10.5.0.tgz",
+      "integrity": "sha512-R5SnVLJmgYYvf2F2ZgwSBnelz5G4q5AxIC277GDfUaNbrZKNANcBC7RHqYYePlszf4kBolVkJauG0ZjHHFh55g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/ipaddr.js": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
+      "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
     "node_modules/is-binary-path": {
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz",
@@ -2836,11 +3438,16 @@
         "node": ">=0.12.0"
       }
     },
+    "node_modules/is-promise": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz",
+      "integrity": "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==",
+      "license": "MIT"
+    },
     "node_modules/isexe": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
       "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
-      "dev": true,
       "license": "ISC"
     },
     "node_modules/istanbul-lib-coverage": {
@@ -2891,6 +3498,15 @@
         "jiti": "bin/jiti.js"
       }
     },
+    "node_modules/jose": {
+      "version": "6.2.9",
+      "resolved": "https://registry.npmjs.org/jose/-/jose-6.2.9.tgz",
+      "integrity": "sha512-XrchZOFZUl/T3vTwRe8XK+cJrGtMF4th1ARnDfwbBXFKThGhlsxEE4Zu03AD/bjJSt/9jT/mxrOCkJWOg77aPA==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/panva"
+      }
+    },
     "node_modules/js-tokens": {
       "version": "10.0.0",
       "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-10.0.0.tgz",
@@ -2924,6 +3540,12 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/json-schema-typed": {
+      "version": "8.0.2",
+      "resolved": "https://registry.npmjs.org/json-schema-typed/-/json-schema-typed-8.0.2.tgz",
+      "integrity": "sha512-fQhoXdcvc3V28x7C7BMs4P5+kNlgUURe2jmUT1T//oBRMDrqy1QPelJimwZGo7Hg9VPV3EQV5Bnq4hbFy2vetA==",
+      "license": "BSD-2-Clause"
+    },
     "node_modules/json-stable-stringify-without-jsonify": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz",
@@ -3066,6 +3688,40 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/media-typer": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-1.1.1.tgz",
+      "integrity": "sha512-yz3xRaG20c6/BOzvYoDaGtPmGscs7YivItZEEqe6GbwNfHuxu9YNmvnEkMzKldAGY4/80pRcQRZSEnhquk9XuQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/merge-descriptors": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz",
+      "integrity": "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/merge2": {
       "version": "1.4.1",
       "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",
@@ -3100,6 +3756,31 @@
         "url": "https://github.com/sponsors/jonschlinkert"
       }
     },
+    "node_modules/mime-db": {
+      "version": "1.54.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz",
+      "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-3.0.2.tgz",
+      "integrity": "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "^1.54.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/minimatch": {
       "version": "10.2.5",
       "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.5.tgz",
@@ -3158,6 +3839,15 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/negotiator": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-1.0.0.tgz",
+      "integrity": "sha512-8Ofs/AUQh8MaEcrlq5xOX0CQ9ypTF5dl78mjlMNfOK08fzpgTHQRQPBxcPlEtIw0yRpws+Zo/3r+5WRby7u3Gg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
     "node_modules/node-releases": {
       "version": "2.0.38",
       "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.38.tgz",
@@ -3191,6 +3881,18 @@
         "node": ">= 6"
       }
     },
+    "node_modules/object-inspect": {
+      "version": "1.13.4",
+      "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
+      "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/obug": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/obug/-/obug-2.1.1.tgz",
@@ -3202,6 +3904,27 @@
       ],
       "license": "MIT"
     },
+    "node_modules/on-finished": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
+      "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
+      "license": "MIT",
+      "dependencies": {
+        "ee-first": "1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/once": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+      "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
+      "license": "ISC",
+      "dependencies": {
+        "wrappy": "1"
+      }
+    },
     "node_modules/optionator": {
       "version": "0.9.4",
       "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz",
@@ -3252,6 +3975,15 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/parseurl": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
+      "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
     "node_modules/path-exists": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
@@ -3266,7 +3998,6 @@
       "version": "3.1.1",
       "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
       "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=8"
@@ -3278,6 +4009,16 @@
       "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==",
       "license": "MIT"
     },
+    "node_modules/path-to-regexp": {
+      "version": "8.4.2",
+      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.4.2.tgz",
+      "integrity": "sha512-qRcuIdP69NPm4qbACK+aDogI5CBDMi1jKe0ry5rSQJz8JVLsC7jV8XpiJjGRLLol3N+R5ihGYcrPLTno6pAdBA==",
+      "license": "MIT",
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/pathe": {
       "version": "2.0.3",
       "resolved": "https://registry.npmjs.org/pathe/-/pathe-2.0.3.tgz",
@@ -3321,6 +4062,15 @@
         "node": ">= 6"
       }
     },
+    "node_modules/pkce-challenge": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/pkce-challenge/-/pkce-challenge-5.0.1.tgz",
+      "integrity": "sha512-wQ0b/W4Fr01qtpHlqSqspcj3EhBvimsdh0KlHhH8HRZnMsEa0ea2fTULOXOS9ccQr3om+GcGRk4e+isrZWV8qQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=16.20.0"
+      }
+    },
     "node_modules/postcss": {
       "version": "8.5.12",
       "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.12.tgz",
@@ -3487,6 +4237,19 @@
         "node": ">= 0.8.0"
       }
     },
+    "node_modules/proxy-addr": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
+      "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
+      "license": "MIT",
+      "dependencies": {
+        "forwarded": "0.2.0",
+        "ipaddr.js": "1.9.1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
     "node_modules/punycode": {
       "version": "2.3.1",
       "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
@@ -3497,6 +4260,22 @@
         "node": ">=6"
       }
     },
+    "node_modules/qs": {
+      "version": "6.15.3",
+      "resolved": "https://registry.npmjs.org/qs/-/qs-6.15.3.tgz",
+      "integrity": "sha512-O9gl3zCl5h5blw1KGUzQKhA5oUXSl8rwUIM5o0S3nCXMliSvy5Dzx7/DJcI+SwgICv+IneSZwhBh1oSyEHA71A==",
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "es-define-property": "^1.0.1",
+        "side-channel": "^1.1.1"
+      },
+      "engines": {
+        "node": ">=0.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/queue-microtask": {
       "version": "1.2.3",
       "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz",
@@ -3517,6 +4296,34 @@
       ],
       "license": "MIT"
     },
+    "node_modules/range-parser": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.3.0.tgz",
+      "integrity": "sha512-hek2mFQpPuI4E1BBKrSto+BU3e3x4xuarsbiwr3+lf7p44juvFMV0XFWQAP3xUyqXA4RrXLIoaSUGbSt056ZMw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/raw-body": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-3.0.2.tgz",
+      "integrity": "sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "~3.1.2",
+        "http-errors": "~2.0.1",
+        "iconv-lite": "~0.7.0",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
     "node_modules/react": {
       "version": "18.3.1",
       "resolved": "https://registry.npmjs.org/react/-/react-18.3.1.tgz",
@@ -3584,6 +4391,15 @@
         "url": "https://github.com/sponsors/jonschlinkert"
       }
     },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
     "node_modules/resolve": {
       "version": "1.22.12",
       "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.12.tgz",
@@ -3659,6 +4475,22 @@
         "fsevents": "~2.3.2"
       }
     },
+    "node_modules/router": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/router/-/router-2.2.0.tgz",
+      "integrity": "sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.4.0",
+        "depd": "^2.0.0",
+        "is-promise": "^4.0.0",
+        "parseurl": "^1.3.3",
+        "path-to-regexp": "^8.0.0"
+      },
+      "engines": {
+        "node": ">= 18"
+      }
+    },
     "node_modules/run-parallel": {
       "version": "1.2.0",
       "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz",
@@ -3682,6 +4514,12 @@
         "queue-microtask": "^1.2.2"
       }
     },
+    "node_modules/safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
+      "license": "MIT"
+    },
     "node_modules/scheduler": {
       "version": "0.23.2",
       "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.23.2.tgz",
@@ -3704,11 +4542,61 @@
         "node": ">=10"
       }
     },
+    "node_modules/send": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/send/-/send-1.2.1.tgz",
+      "integrity": "sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.4.3",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "etag": "^1.8.1",
+        "fresh": "^2.0.0",
+        "http-errors": "^2.0.1",
+        "mime-types": "^3.0.2",
+        "ms": "^2.1.3",
+        "on-finished": "^2.4.1",
+        "range-parser": "^1.2.1",
+        "statuses": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/serve-static": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-2.2.1.tgz",
+      "integrity": "sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw==",
+      "license": "MIT",
+      "dependencies": {
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "parseurl": "^1.3.3",
+        "send": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/setprototypeof": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
+      "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
+      "license": "ISC"
+    },
     "node_modules/shebang-command": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
       "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "shebang-regex": "^3.0.0"
@@ -3721,12 +4609,83 @@
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
       "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=8"
       }
     },
+    "node_modules/side-channel": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.1.tgz",
+      "integrity": "sha512-6x6dK6zJdpTzF4sQeNYxwtvBzf6Eg4GtlesS94HOvTudUeyK2WXAaIfmDgsyslYrRBeFIlsi54AYsFGUuhmvrQ==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.4",
+        "side-channel-list": "^1.0.1",
+        "side-channel-map": "^1.0.1",
+        "side-channel-weakmap": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-list": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.1.tgz",
+      "integrity": "sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.4"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-map": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
+      "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-weakmap": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
+      "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3",
+        "side-channel-map": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
     "node_modules/siginfo": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/siginfo/-/siginfo-2.0.0.tgz",
@@ -3750,6 +4709,15 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/statuses": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
+      "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
     "node_modules/std-env": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/std-env/-/std-env-4.0.0.tgz",
@@ -3917,6 +4885,15 @@
         "node": ">=8.0"
       }
     },
+    "node_modules/toidentifier": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
+      "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.6"
+      }
+    },
     "node_modules/ts-api-utils": {
       "version": "2.5.0",
       "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.5.0.tgz",
@@ -3955,6 +4932,37 @@
         "node": ">= 0.8.0"
       }
     },
+    "node_modules/type-is": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/type-is/-/type-is-2.1.0.tgz",
+      "integrity": "sha512-faYHw0anBbc/kWF3zFTEnxSFOAGUX9GFbOBthvDdLsIlEoWOFOtS0zgCiQYwIskL9iGXZL3kAXD8OoZ4GmMATA==",
+      "license": "MIT",
+      "dependencies": {
+        "content-type": "^2.0.0",
+        "media-typer": "^1.1.0",
+        "mime-types": "^3.0.0"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/type-is/node_modules/content-type": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/content-type/-/content-type-2.1.0.tgz",
+      "integrity": "sha512-mj7UPXE0jaqaOsukNZRUEfEi2AcL7C/vwmwcHV0O97eO1E1pxBZuyjlZrx5seTaNBg1U6+o35wpa35Qfcc+7ag==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
     "node_modules/typescript": {
       "version": "5.9.3",
       "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
@@ -4000,6 +5008,15 @@
       "devOptional": true,
       "license": "MIT"
     },
+    "node_modules/unpipe": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
+      "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
     "node_modules/update-browserslist-db": {
       "version": "1.2.3",
       "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.2.3.tgz",
@@ -4046,6 +5063,15 @@
       "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
       "license": "MIT"
     },
+    "node_modules/vary": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
+      "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
     "node_modules/vite": {
       "version": "6.4.2",
       "resolved": "https://registry.npmjs.org/vite/-/vite-6.4.2.tgz",
@@ -4214,7 +5240,6 @@
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
       "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
-      "dev": true,
       "license": "ISC",
       "dependencies": {
         "isexe": "^2.0.0"
@@ -4253,6 +5278,12 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/wrappy": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+      "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
+      "license": "ISC"
+    },
     "node_modules/yallist": {
       "version": "3.1.1",
       "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz",
@@ -4272,12 +5303,30 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
+    "node_modules/zod": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-4.4.3.tgz",
+      "integrity": "sha512-ytENFjIJFl2UwYglde2jchW2Hwm4GJFLDiSXWdTrJQBIN9Fcyp7n4DhxJEiWNAJMV1/BqWfW/kkg71UDcHJyTQ==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/colinhacks"
+      }
+    },
+    "node_modules/zod-to-json-schema": {
+      "version": "3.25.2",
+      "resolved": "https://registry.npmjs.org/zod-to-json-schema/-/zod-to-json-schema-3.25.2.tgz",
+      "integrity": "sha512-O/PgfnpT1xKSDeQYSCfRI5Gy3hPf91mKVDuYLUHZJMiDFptvP41MSnWofm8dnCm0256ZNfZIM7DSzuSMAFnjHA==",
+      "license": "ISC",
+      "peerDependencies": {
+        "zod": "^3.25.28 || ^4"
+      }
+    },
     "packages/adapters": {
       "name": "@kiploks/engine-adapters",
-      "version": "0.4.2",
+      "version": "0.4.3",
       "license": "Apache-2.0",
       "dependencies": {
-        "@kiploks/engine-contracts": "0.4.2"
+        "@kiploks/engine-contracts": "0.4.3"
       },
       "devDependencies": {
         "typescript": "^5.9.3"
@@ -4285,13 +5334,13 @@
     },
     "packages/cli": {
       "name": "@kiploks/engine-cli",
-      "version": "0.4.2",
+      "version": "0.4.3",
       "license": "Apache-2.0",
       "dependencies": {
         "@dedalik/use-react": "^1.1.1",
-        "@kiploks/engine-adapters": "0.4.2",
-        "@kiploks/engine-contracts": "0.4.2",
-        "@kiploks/engine-core": "0.4.2",
+        "@kiploks/engine-adapters": "0.4.3",
+        "@kiploks/engine-contracts": "0.4.3",
+        "@kiploks/engine-core": "0.4.3",
         "@vitejs/plugin-react": "^4.3.4",
         "autoprefixer": "^10.4.20",
         "postcss": "^8.5.12",
@@ -4312,7 +5361,7 @@
     },
     "packages/contracts": {
       "name": "@kiploks/engine-contracts",
-      "version": "0.4.2",
+      "version": "0.4.3",
       "license": "Apache-2.0",
       "devDependencies": {
         "typescript": "^5.9.3"
@@ -4320,10 +5369,28 @@
     },
     "packages/core": {
       "name": "@kiploks/engine-core",
-      "version": "0.4.2",
+      "version": "0.4.3",
       "license": "Apache-2.0",
       "dependencies": {
-        "@kiploks/engine-contracts": "0.4.2"
+        "@kiploks/engine-contracts": "0.4.3"
+      },
+      "devDependencies": {
+        "typescript": "^5.9.3"
+      }
+    },
+    "packages/mcp-server": {
+      "name": "@kiploks/engine-mcp",
+      "version": "0.4.3",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@kiploks/engine-adapters": "0.4.3",
+        "@kiploks/engine-contracts": "0.4.3",
+        "@kiploks/engine-core": "0.4.3",
+        "@modelcontextprotocol/sdk": "^1.12.1",
+        "tslib": "^2.8.1"
+      },
+      "bin": {
+        "kiploks-mcp": "bin/kiploks-mcp.cjs"
       },
       "devDependencies": {
         "typescript": "^5.9.3"
@@ -4331,7 +5398,7 @@
     },
     "packages/test-vectors": {
       "name": "@kiploks/engine-test-vectors",
-      "version": "0.4.2",
+      "version": "0.4.3",
       "license": "Apache-2.0"
     }
   }
diff --git a/package.json b/package.json
index bb657fb..3af98f3 100644
--- a/package.json
+++ b/package.json
@@ -28,7 +28,7 @@
   },
   "scripts": {
     "sync-versions": "node scripts/sync-engine-versions.mjs",
-    "build": "npm run build -w @kiploks/engine-contracts -w @kiploks/engine-core -w @kiploks/engine-adapters -w @kiploks/engine-cli",
+    "build": "npm run build -w @kiploks/engine-contracts -w @kiploks/engine-core -w @kiploks/engine-adapters -w @kiploks/engine-cli -w @kiploks/engine-mcp",
     "ui": "npm run build:code -w @kiploks/engine-cli && npm run ui -w @kiploks/engine-cli",
     "ui:no-open": "npm run build:code -w @kiploks/engine-cli && node packages/cli/dist/index.js ui --watch --no-open",
     "lint": "eslint .",
@@ -40,7 +40,8 @@
     "engine:validate": "npm run lint && npm run test && npm run engine:check:boundary && npm run engine:check:bundle",
     "engine:examples:generate-samples": "node docs/examples/scripts/generate-samples.mjs",
     "engine:examples:generate-monte-carlo-fixture": "node docs/examples/scripts/generate-monte-carlo-seed42.mjs",
-    "engine:publish:dry-run": "npm publish --dry-run -w @kiploks/engine-contracts -w @kiploks/engine-core -w @kiploks/engine-adapters -w @kiploks/engine-cli -w @kiploks/engine-test-vectors"
+    "engine:publish:dry-run": "npm publish --dry-run -w @kiploks/engine-contracts -w @kiploks/engine-core -w @kiploks/engine-adapters -w @kiploks/engine-cli -w @kiploks/engine-mcp -w @kiploks/engine-test-vectors",
+    "mcp:kiploks": "node packages/mcp-server/dist/index.js"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
diff --git a/packages/mcp-server/README.md b/packages/mcp-server/README.md
new file mode 100644
index 0000000..9eb5064
--- /dev/null
+++ b/packages/mcp-server/README.md
@@ -0,0 +1,53 @@
+# @kiploks/engine-mcp
+
+MCP server for the [Kiploks open-source engine](https://github.com/kiploks/engine).
+
+## Install
+
+```bash
+npx -y @kiploks/engine-mcp
+```
+
+From checkout:
+
+```bash
+npm install
+npm run build -w @kiploks/engine-mcp
+node packages/mcp-server/dist/index.js
+```
+
+## MCP config
+
+```json
+{
+  "mcpServers": {
+    "kiploks": {
+      "command": "npx",
+      "args": ["-y", "@kiploks/engine-mcp"],
+      "env": {
+        "KIPLOKS_ORCHESTRATOR_URL": "http://127.0.0.1:41731",
+        "KIPLOKS_ORCHESTRATOR_TOKEN": "optional-from-kiploks.json"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Needs orchestrator? |
+| --- | --- |
+| `kiploks_analyze_trades` | No |
+| `kiploks_analyze_integration_payload` | No |
+| `kiploks_orchestrator_status` | Yes |
+| `kiploks_list_backtests` | Yes |
+| `kiploks_list_reports` | Yes |
+| `kiploks_get_report` | Yes |
+| `kiploks_register_freqtrade_path` | Yes |
+| `kiploks_bootstrap_integration` | Yes |
+| `kiploks_run_backtest_analysis` | Yes |
+| `kiploks_get_job` | Yes |
+
+Start orchestrator: `npx -y @kiploks/engine-cli ui --no-open`
+
+See [docs/AI_AGENTS.md](../../docs/AI_AGENTS.md) for workflows.
diff --git a/packages/mcp-server/bin/kiploks-mcp.cjs b/packages/mcp-server/bin/kiploks-mcp.cjs
new file mode 100755
index 0000000..a8f4cae
--- /dev/null
+++ b/packages/mcp-server/bin/kiploks-mcp.cjs
@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+"use strict";
+require("../dist/index.js");
diff --git a/packages/mcp-server/package.json b/packages/mcp-server/package.json
new file mode 100644
index 0000000..86cae4e
--- /dev/null
+++ b/packages/mcp-server/package.json
@@ -0,0 +1,50 @@
+{
+  "name": "@kiploks/engine-mcp",
+  "version": "0.4.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kiploks/engine.git"
+  },
+  "homepage": "https://github.com/kiploks/engine#readme",
+  "bugs": {
+    "url": "https://github.com/kiploks/engine/issues"
+  },
+  "description": "MCP server for Kiploks engine - AI agents can analyze backtests and fetch reports",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "algorithmic-trading",
+    "walk-forward-analysis",
+    "backtest",
+    "kiploks",
+    "ai-agent"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "kiploks-mcp": "bin/kiploks-mcp.cjs"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "@kiploks/engine-adapters": "0.4.3",
+    "@kiploks/engine-contracts": "0.4.3",
+    "@kiploks/engine-core": "0.4.3",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "tslib": "^2.8.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "license": "Apache-2.0"
+}
diff --git a/packages/mcp-server/src/engineTools.ts b/packages/mcp-server/src/engineTools.ts
new file mode 100644
index 0000000..2622b8a
--- /dev/null
+++ b/packages/mcp-server/src/engineTools.ts
@@ -0,0 +1,95 @@
+import { createReadStream } from "node:fs";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+
+import { csvToTradesFromStream } from "@kiploks/engine-adapters";
+import type { AnalyzeConfig, Trade, WindowConfig } from "@kiploks/engine-contracts";
+import { analyzeFromTrades, mapPayloadToUnified } from "@kiploks/engine-core";
+import { buildTestResultDataFromUnified } from "@kiploks/engine-core/server";
+
+export type AnalyzeTradesInput = {
+  inputPath: string;
+  inSampleMonths?: number;
+  outOfSampleMonths?: number;
+  stepMode?: "rolling" | "anchored";
+  seed?: number;
+  decimals?: number;
+  permutationN?: number;
+  initialBalance?: number;
+};
+
+function buildConfig(input: AnalyzeTradesInput): AnalyzeConfig {
+  const config: AnalyzeConfig = {};
+  if (typeof input.seed === "number" && Number.isFinite(input.seed)) config.seed = input.seed;
+  if (typeof input.decimals === "number" && Number.isFinite(input.decimals)) config.decimals = input.decimals;
+  if (typeof input.permutationN === "number" && Number.isFinite(input.permutationN)) {
+    config.permutationN = input.permutationN;
+  }
+  return config;
+}
+
+function toWindowConfig(input: AnalyzeTradesInput): WindowConfig {
+  return {
+    inSampleMonths: input.inSampleMonths ?? 6,
+    outOfSampleMonths: input.outOfSampleMonths ?? 2,
+    stepMode: input.stepMode ?? "rolling",
+  };
+}
+
+function parseProfit(row: Record<string, unknown>, balance: number): number | null {
+  if (Number.isFinite(Number(row.profit))) return Number(row.profit);
+  if (Number.isFinite(Number(row.profit_ratio))) return Number(row.profit_ratio);
+  if (Number.isFinite(Number(row.profit_abs))) return Number(row.profit_abs) / balance;
+  return null;
+}
+
+async function loadTrades(inputPath: string, initialBalance?: number): Promise<Trade[]> {
+  const abs = path.resolve(inputPath);
+  if (abs.toLowerCase().endsWith(".csv")) {
+    return csvToTradesFromStream(createReadStream(abs), {
+      profit: "profit",
+      openTime: "openTime",
+      closeTime: "closeTime",
+    });
+  }
+
+  const raw = JSON.parse(await readFile(abs, "utf8")) as unknown;
+  if (!Array.isArray(raw)) {
+    throw new Error("JSON input must be Trade[] array. Bot export JSON is not supported in-tree.");
+  }
+
+  const balance = initialBalance ?? 1;
+  const out: Trade[] = [];
+  for (const row of raw as Record<string, unknown>[]) {
+    if (!row || typeof row !== "object") continue;
+    const profit = parseProfit(row, balance);
+    const openTime = Number(row.openTime ?? row.open_timestamp);
+    const closeTime = Number(row.closeTime ?? row.close_timestamp);
+    if (profit == null || !Number.isFinite(openTime) || !Number.isFinite(closeTime)) continue;
+    out.push({
+      profit,
+      openTime,
+      closeTime,
+      ...(typeof row.symbol === "string" ? { symbol: row.symbol } : {}),
+      ...(typeof row.direction === "string" ? { direction: row.direction as Trade["direction"] } : {}),
+    });
+  }
+  if (out.length === 0) throw new Error("No valid trades found in input file");
+  return out;
+}
+
+export async function analyzeTradesFile(input: AnalyzeTradesInput): Promise<unknown> {
+  return analyzeFromTrades(
+    {
+      trades: await loadTrades(input.inputPath, input.initialBalance),
+      windowConfig: toWindowConfig(input),
+      wfaInputMode: "tradeSlicedPseudoWfa",
+    },
+    buildConfig(input),
+  );
+}
+
+export async function analyzeIntegrationPayloadFile(inputPath: string): Promise<unknown> {
+  const raw = JSON.parse(await readFile(path.resolve(inputPath), "utf8")) as Record<string, unknown>;
+  return buildTestResultDataFromUnified(mapPayloadToUnified(raw), `mcp_${Date.now()}`);
+}
diff --git a/packages/mcp-server/src/index.ts b/packages/mcp-server/src/index.ts
new file mode 100644
index 0000000..5fa2b70
--- /dev/null
+++ b/packages/mcp-server/src/index.ts
@@ -0,0 +1,39 @@
+import { ENGINE_VERSION } from "@kiploks/engine-contracts";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+
+import { handleToolCall } from "./toolHandlers";
+import { MCP_TOOLS } from "./tools";
+
+export async function runMcpServer(): Promise<void> {
+  const server = new Server(
+    { name: "kiploks-engine", version: ENGINE_VERSION },
+    { capabilities: { tools: {} } },
+  );
+
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: MCP_TOOLS }));
+
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+      const args = (request.params.arguments ?? {}) as Record<string, unknown>;
+      return await handleToolCall(request.params.name, args);
+    } catch (error: unknown) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        content: [{ type: "text", text: JSON.stringify({ error: message }, null, 2) }],
+        isError: true,
+      };
+    }
+  });
+
+  await server.connect(new StdioServerTransport());
+}
+
+if (require.main === module) {
+  runMcpServer().catch((error: unknown) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`kiploks-mcp failed: ${message}\n`);
+    process.exit(1);
+  });
+}
diff --git a/packages/mcp-server/src/orchestratorClient.ts b/packages/mcp-server/src/orchestratorClient.ts
new file mode 100644
index 0000000..6f7176a
--- /dev/null
+++ b/packages/mcp-server/src/orchestratorClient.ts
@@ -0,0 +1,147 @@
+const DEFAULT_ORCHESTRATOR_URL = "http://127.0.0.1:41731";
+
+export type OrchestratorConfig = {
+  baseUrl: string;
+  apiToken?: string;
+};
+
+export function resolveOrchestratorConfig(env: NodeJS.ProcessEnv = process.env): OrchestratorConfig {
+  const baseUrl = (env.KIPLOKS_ORCHESTRATOR_URL ?? DEFAULT_ORCHESTRATOR_URL).replace(/\/+$/, "");
+  const apiToken = env.KIPLOKS_ORCHESTRATOR_TOKEN?.trim() || undefined;
+  return { baseUrl, apiToken };
+}
+
+export class OrchestratorHttpError extends Error {
+  readonly status: number;
+  readonly body: unknown;
+
+  constructor(status: number, body: unknown, message: string) {
+    super(message);
+    this.status = status;
+    this.body = body;
+  }
+}
+
+async function readJsonResponse(res: Response): Promise<unknown> {
+  const text = await res.text();
+  if (!text.trim()) return null;
+  try {
+    return JSON.parse(text) as unknown;
+  } catch {
+    return text;
+  }
+}
+
+export async function orchestratorFetch(
+  config: OrchestratorConfig,
+  path: string,
+  init: RequestInit = {},
+): Promise<unknown> {
+  const headers = new Headers(init.headers ?? {});
+  if (!headers.has("Accept")) headers.set("Accept", "application/json");
+  if (config.apiToken) headers.set("Authorization", `Bearer ${config.apiToken}`);
+  if (init.body && !headers.has("Content-Type")) headers.set("Content-Type", "application/json");
+
+  const res = await fetch(`${config.baseUrl}${path}`, { ...init, headers });
+  const body = await readJsonResponse(res);
+  if (!res.ok) {
+    const message =
+      typeof body === "object" && body && "error" in body
+        ? String((body as { error: unknown }).error)
+        : `HTTP ${res.status}`;
+    throw new OrchestratorHttpError(res.status, body, message);
+  }
+  return body;
+}
+
+export async function getApiInfo(config: OrchestratorConfig): Promise<unknown> {
+  return orchestratorFetch(config, "/api-info", { method: "GET" });
+}
+
+export async function listBacktests(
+  config: OrchestratorConfig,
+  integration: "freqtrade" = "freqtrade",
+  botId?: string,
+): Promise<unknown> {
+  const q = new URLSearchParams({ integration });
+  if (botId?.trim()) q.set("bot", botId.trim());
+  return orchestratorFetch(config, `/integrations/backtests?${q.toString()}`, { method: "GET" });
+}
+
+export async function listReports(config: OrchestratorConfig): Promise<unknown> {
+  return orchestratorFetch(config, "/api/reports", { method: "GET" });
+}
+
+export async function getReport(config: OrchestratorConfig, reportId: string): Promise<unknown> {
+  return orchestratorFetch(config, `/api/reports/${encodeURIComponent(reportId)}`, { method: "GET" });
+}
+
+export type RunIntegrationInput = {
+  integration?: "freqtrade" | "octobot";
+  selectedArtifactKeys?: string[];
+  botId?: string;
+  mode?: "docker" | "host" | "wrapper";
+};
+
+export async function startIntegrationRun(
+  config: OrchestratorConfig,
+  input: RunIntegrationInput,
+): Promise<{ jobId: string; raw: unknown }> {
+  const raw = await orchestratorFetch(config, "/integrations/run", {
+    method: "POST",
+    body: JSON.stringify(input),
+  });
+  const jobId =
+    typeof raw === "object" && raw && "id" in raw ? String((raw as { id: unknown }).id) : "";
+  if (!jobId) throw new Error("Integration run did not return a job id");
+  return { jobId, raw };
+}
+
+export async function getJob(config: OrchestratorConfig, jobId: string): Promise<unknown> {
+  return orchestratorFetch(config, `/jobs/${encodeURIComponent(jobId)}`, { method: "GET" });
+}
+
+export async function getJobResult(config: OrchestratorConfig, jobId: string): Promise<unknown> {
+  return orchestratorFetch(config, `/jobs/${encodeURIComponent(jobId)}/result`, { method: "GET" });
+}
+
+export async function waitForJob(
+  config: OrchestratorConfig,
+  jobId: string,
+  opts: { timeoutMs?: number; pollMs?: number } = {},
+): Promise<unknown> {
+  const timeoutMs = opts.timeoutMs ?? 15 * 60 * 1000;
+  const pollMs = opts.pollMs ?? 2000;
+  const started = Date.now();
+
+  while (Date.now() - started < timeoutMs) {
+    const job = await getJob(config, jobId);
+    const status =
+      typeof job === "object" && job && "status" in job ? String((job as { status: unknown }).status) : "";
+    if (status === "succeeded" || status === "failed" || status === "cancelled") {
+      return job;
+    }
+    await new Promise((r) => setTimeout(r, pollMs));
+  }
+  throw new Error(`Timed out waiting for job ${jobId}`);
+}
+
+export async function registerFreqtradePath(
+  config: OrchestratorConfig,
+  freqtradePath: string,
+): Promise<unknown> {
+  return orchestratorFetch(config, "/paths/register", {
+    method: "POST",
+    body: JSON.stringify({ integration: "freqtrade", path: freqtradePath }),
+  });
+}
+
+export async function bootstrapIntegration(
+  config: OrchestratorConfig,
+  integration: "freqtrade" | "octobot" = "freqtrade",
+): Promise<unknown> {
+  return orchestratorFetch(config, "/integrations/bootstrap", {
+    method: "POST",
+    body: JSON.stringify({ integration }),
+  });
+}
diff --git a/packages/mcp-server/src/toolHandlers.ts b/packages/mcp-server/src/toolHandlers.ts
new file mode 100644
index 0000000..dc558d5
--- /dev/null
+++ b/packages/mcp-server/src/toolHandlers.ts
@@ -0,0 +1,113 @@
+import { analyzeIntegrationPayloadFile, analyzeTradesFile } from "./engineTools";
+import {
+  bootstrapIntegration,
+  getApiInfo,
+  getJob,
+  getJobResult,
+  getReport,
+  listBacktests,
+  listReports,
+  registerFreqtradePath,
+  resolveOrchestratorConfig,
+  startIntegrationRun,
+  waitForJob,
+} from "./orchestratorClient";
+
+function textResult(payload: unknown) {
+  return {
+    content: [{ type: "text" as const, text: JSON.stringify(payload, null, 2) }],
+  };
+}
+
+function readString(args: Record<string, unknown>, key: string, required = true): string {
+  const v = args[key];
+  if (typeof v === "string" && v.trim()) return v.trim();
+  if (!required) return "";
+  throw new Error(`Missing required argument: ${key}`);
+}
+
+function readNumber(args: Record<string, unknown>, key: string): number | undefined {
+  const v = args[key];
+  if (v == null) return undefined;
+  const n = Number(v);
+  return Number.isFinite(n) ? n : undefined;
+}
+
+export async function handleToolCall(name: string, args: Record<string, unknown>) {
+  const orch = resolveOrchestratorConfig();
+
+  switch (name) {
+    case "kiploks_analyze_trades":
+      return textResult(
+        await analyzeTradesFile({
+          inputPath: readString(args, "input_path"),
+          inSampleMonths: readNumber(args, "in_sample_months"),
+          outOfSampleMonths: readNumber(args, "out_of_sample_months"),
+          stepMode: (args.step_mode as "rolling" | "anchored" | undefined) ?? "rolling",
+          seed: readNumber(args, "seed"),
+          decimals: readNumber(args, "decimals"),
+          permutationN: readNumber(args, "permutation_n"),
+          initialBalance: readNumber(args, "initial_balance"),
+        }),
+      );
+
+    case "kiploks_analyze_integration_payload":
+      return textResult(await analyzeIntegrationPayloadFile(readString(args, "input_path")));
+
+    case "kiploks_orchestrator_status":
+      return textResult(await getApiInfo(orch));
+
+    case "kiploks_list_backtests":
+      return textResult(
+        await listBacktests(
+          orch,
+          (args.integration as "freqtrade" | undefined) ?? "freqtrade",
+          readString(args, "bot_id", false) || undefined,
+        ),
+      );
+
+    case "kiploks_list_reports":
+      return textResult(await listReports(orch));
+
+    case "kiploks_get_report":
+      return textResult(await getReport(orch, readString(args, "report_id")));
+
+    case "kiploks_register_freqtrade_path":
+      return textResult(await registerFreqtradePath(orch, readString(args, "path")));
+
+    case "kiploks_bootstrap_integration":
+      return textResult(
+        await bootstrapIntegration(orch, (args.integration as "freqtrade" | "octobot" | undefined) ?? "freqtrade"),
+      );
+
+    case "kiploks_run_backtest_analysis": {
+      const keys = args.selected_artifact_keys;
+      if (!Array.isArray(keys) || keys.length === 0) {
+        throw new Error("selected_artifact_keys must be a non-empty string array");
+      }
+      const wait = args.wait !== false;
+      const { jobId, raw: started } = await startIntegrationRun(orch, {
+        integration: (args.integration as "freqtrade" | "octobot" | undefined) ?? "freqtrade",
+        selectedArtifactKeys: keys.map(String),
+        botId: readString(args, "bot_id", false) || undefined,
+        mode: (args.mode as "docker" | "host" | "wrapper" | undefined) ?? "docker",
+      });
+      if (!wait) return textResult({ started, jobId });
+      const job = await waitForJob(orch, jobId, { timeoutMs: readNumber(args, "timeout_ms") ?? 900_000 });
+      const result = await getJobResult(orch, jobId);
+      return textResult({ jobId, job, result });
+    }
+
+    case "kiploks_get_job": {
+      const jobId = readString(args, "job_id");
+      const job = await getJob(orch, jobId);
+      if (args.include_result === true) {
+        return textResult({ job, result: await getJobResult(orch, jobId) });
+      }
+      return textResult(job);
+    }
+
+    default:
+      throw new Error(`Unknown tool: ${name}`);
+  }
+}
diff --git a/packages/mcp-server/src/tools.ts b/packages/mcp-server/src/tools.ts
new file mode 100644
index 0000000..5e77d6c
--- /dev/null
+++ b/packages/mcp-server/src/tools.ts
@@ -0,0 +1,114 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+
+export const MCP_TOOLS: Tool[] = [
+  {
+    name: "kiploks_analyze_trades",
+    description: "Run WFA on a local trades JSON or CSV file. No orchestrator required.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        input_path: { type: "string", description: "Path to trades JSON array or CSV" },
+        in_sample_months: { type: "number", description: "In-sample months (default 6)" },
+        out_of_sample_months: { type: "number", description: "Out-of-sample months (default 2)" },
+        step_mode: { type: "string", enum: ["rolling", "anchored"] },
+        seed: { type: "number" },
+        decimals: { type: "number" },
+        permutation_n: { type: "number", description: "WFE permutation count (100..10000)" },
+        initial_balance: { type: "number", description: "When trades only have profit_abs" },
+      },
+      required: ["input_path"],
+    },
+  },
+  {
+    name: "kiploks_analyze_integration_payload",
+    description: "Build full TestResultData from an integration payload JSON file.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        input_path: { type: "string", description: "Integration payload JSON path" },
+      },
+      required: ["input_path"],
+    },
+  },
+  {
+    name: "kiploks_orchestrator_status",
+    description: "Check local orchestrator via GET /api-info.",
+    inputSchema: { type: "object", properties: {} },
+  },
+  {
+    name: "kiploks_list_backtests",
+    description: "List Freqtrade backtest artifacts from a running orchestrator.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        integration: { type: "string", enum: ["freqtrade"] },
+        bot_id: { type: "string" },
+      },
+    },
+  },
+  {
+    name: "kiploks_list_reports",
+    description: "List reports stored in the local orchestrator.",
+    inputSchema: { type: "object", properties: {} },
+  },
+  {
+    name: "kiploks_get_report",
+    description: "Fetch report JSON by id.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        report_id: { type: "string" },
+      },
+      required: ["report_id"],
+    },
+  },
+  {
+    name: "kiploks_register_freqtrade_path",
+    description: "Register a Freqtrade install path with the orchestrator.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Absolute path to Freqtrade install root" },
+      },
+      required: ["path"],
+    },
+  },
+  {
+    name: "kiploks_bootstrap_integration",
+    description: "Bootstrap kiploks-freqtrade or kiploks-octobot bridge.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        integration: { type: "string", enum: ["freqtrade", "octobot"] },
+      },
+    },
+  },
+  {
+    name: "kiploks_run_backtest_analysis",
+    description: "Run integration for selected backtest artifacts and wait for completion.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        selected_artifact_keys: { type: "array", items: { type: "string" } },
+        integration: { type: "string", enum: ["freqtrade", "octobot"] },
+        bot_id: { type: "string" },
+        mode: { type: "string", enum: ["docker", "host", "wrapper"] },
+        wait: { type: "boolean", description: "Wait for job (default true)" },
+        timeout_ms: { type: "number", description: "Wait timeout ms (default 900000)" },
+      },
+      required: ["selected_artifact_keys"],
+    },
+  },
+  {
+    name: "kiploks_get_job",
+    description: "Get integration job status by id.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        job_id: { type: "string" },
+        include_result: { type: "boolean" },
+      },
+      required: ["job_id"],
+    },
+  },
+];
diff --git a/packages/mcp-server/tsconfig.build.json b/packages/mcp-server/tsconfig.build.json
new file mode 100644
index 0000000..b5c26b7
--- /dev/null
+++ b/packages/mcp-server/tsconfig.build.json
@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2021",
+    "module": "commonjs",
+    "lib": ["ES2021"],
+    "moduleResolution": "node",
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"]
+}
diff --git a/scripts/sync-engine-versions.mjs b/scripts/sync-engine-versions.mjs
index 1c0c9d4..bf7af63 100644
--- a/scripts/sync-engine-versions.mjs
+++ b/scripts/sync-engine-versions.mjs
@@ -16,6 +16,7 @@ const PACKAGES = [
   "packages/core",
   "packages/adapters",
   "packages/cli",
+  "packages/mcp-server",
   "packages/test-vectors",
 ];