@gloriginmind/mcp 0.1.2 → 0.1.4

package/README.md

@@ -1,6 +1,6 @@
 # OriginMind MCP
 
-MCP server for OriginMind dual-auth skill routes. Auth is the same Bootstrap OAuth path as skills (`ORIGINMIND_API_KEY` → `~/.originmind/.env`). No MCP-specific OAuth.
+MCP server for OriginMind dual-auth skill routes. Auth is the same Bootstrap OAuth path as skills (`ORIGINMIND_API_KEY`). No MCP-specific OAuth.
 
 ## Prerequisites
 
@@ -8,32 +8,30 @@ MCP server for OriginMind dual-auth skill routes. Auth is the same Bootstrap OAu
 . ./skills/create/scripts/setup-oauth.ps1
 ```
 
-Key lands in `~/.originmind/.env`. Do **not** paste it into `mcp.json`.
+Key lands in `~/.originmind/.env`. Expose it to Cursor via OS/user env or Cursor settings — do **not** paste into committed `mcp.json`.
 
-## Cursor — preferred (HTTP URL)
-
-Run the HTTP server once (separate terminal / service):
-
-```powershell
-npx -y -p @gloriginmind/mcp originmind-mcp-http
-# or local: node path/to/skills/mcp/dist/http.js
-```
-
-Defaults: `http://127.0.0.1:3920/mcp` (`ORIGINMIND_MCP_PORT`, `ORIGINMIND_MCP_HOST`).
-
-Cursor `mcp.json`:
+## Cursor — preferred (hosted HTTP)
 
 ```json
 {
   "mcpServers": {
     "originmind": {
-      "url": "http://127.0.0.1:3920/mcp"
+      "url": "https://api.originmind.ai/mcp",
+      "headers": {
+        "X-OriAI-Api-Key": "${env:ORIGINMIND_API_KEY}"
+      }
     }
   }
 }
 ```
 
-The HTTP process reads `ORIGINMIND_API_KEY` from the machine env / `~/.originmind/.env`. Optional override via headers:
+Bearer JWT also works: `"Authorization": "Bearer ${env:SUPABASE_ACCESS_TOKEN}"` (or your session token).
+
+Health: `GET https://api.originmind.ai/mcp/health`
+
+## Local fallbacks
+
+**Local HTTP** (orchestrator `npm run dev`, or package HTTP entry):
 
 ```json
 {
@@ -48,11 +46,9 @@ The HTTP process reads `ORIGINMIND_API_KEY` from the machine env / `~/.originmin
 }
 ```
 
-Hosted production URL (e.g. on `api.originmind.ai`) is not shipped yet — local HTTP first.
+Package HTTP server: `npx -y -p @gloriginmind/mcp originmind-mcp-http` (port `ORIGINMIND_MCP_PORT`, default 3920). When using orchestrator locally, MCP is at the same host as the API (e.g. `http://127.0.0.1:<port>/mcp`).
 
-## Cursor — stdio (alternative)
-
-Avoids a long-running process; `npx` can be slow on some networks:
+**stdio:**
 
 ```json
 {
@@ -66,24 +62,23 @@ Avoids a long-running process; `npx` can be slow on some networks:
 }
 ```
 
-Or `npx -y @gloriginmind/mcp` (pulls latest; first connect may be slow).
+Or `npx -y @gloriginmind/mcp` (first connect may be slow on some networks).
 
 ## Transports
 
 | Transport | Entry | Use |
 |-----------|-------|-----|
-| **HTTP** | `originmind-mcp-http` / `dist/http.js` | Cursor `url`, LiveKit `MCPServerHTTP` |
+| **Hosted HTTP** | `https://api.originmind.ai/mcp` | Cursor `url` (primary) |
+| **Package HTTP** | `originmind-mcp-http` / `dist/http.js` | Local / LiveKit |
 | **stdio** | `mcp` / `originmind-mcp` / `dist/stdio.js` | Cursor command |
 
-Health: `GET /health`.
-
 ### LiveKit (documented, not wired this pass)
 
 ```python
 from livekit.agents import mcp
 
 mcp.MCPServerHTTP(
-    url=f"http://127.0.0.1:{port}/mcp",
+    url="https://api.originmind.ai/mcp",
     headers={"Authorization": f"Bearer {jwt}"},
 )
 ```
@@ -97,6 +92,14 @@ mcp.MCPServerHTTP(
 
 Notion tools are **not** exposed (parked).
 
+## Package exports
+
+```ts
+import { createServer } from "@gloriginmind/mcp/server";
+```
+
+Used by the orchestrator to host `/mcp`. Server metadata includes OriginMind icons from `https://app.originmind.ai/icon-128.png` (plus 96 / 512).
+
 ## Dev
 
 ```bash

package/dist/tools.d.ts

@@ -5,6 +5,8 @@ export type ToolAuthContext = {
     getAuthorizationHeader?: () => string | null | undefined;
     /** Per-request X-OriAI-Api-Key (HTTP / Cursor headers). */
     getApiKeyHeader?: () => string | null | undefined;
+    /** Override API base URL (orchestrator self-call / local). */
+    baseUrl?: string;
 };
 /** Zod shapes exported for unit tests. */
 export declare const toolSchemas: {

package/dist/tools.js

@@ -16,7 +16,7 @@ function clientFor(ctx) {
     });
     if ("error" in auth)
         return { error: MISSING_KEY_MESSAGE };
-    return new OriginMindClient(auth);
+    return new OriginMindClient(auth, ctx.baseUrl);
 }
 async function runTool(ctx, fn) {
     const client = clientFor(ctx);
@@ -106,7 +106,26 @@ export const toolSchemas = {
 export function createServer(authCtx = {}) {
     const server = new McpServer({
         name: "originmind",
-        version: "0.1.0",
+        title: "OriginMind",
+        version: "0.1.4",
+        websiteUrl: "https://app.originmind.ai",
+        icons: [
+            {
+                src: "https://app.originmind.ai/icon-128.png",
+                mimeType: "image/png",
+                sizes: ["128x128"],
+            },
+            {
+                src: "https://app.originmind.ai/icon-96.png",
+                mimeType: "image/png",
+                sizes: ["96x96"],
+            },
+            {
+                src: "https://app.originmind.ai/2505_OM_logo_Icon_512.png",
+                mimeType: "image/png",
+                sizes: ["512x512"],
+            },
+        ],
     });
     server.tool("list_projects", "List OriginMind projects for the authenticated user (GET /api/v1/projects).", toolSchemas.list_projects.shape, async () => runTool(authCtx, (c) => c.get("/api/v1/projects")));
     server.tool("search_creative_dna", "Search Creative DNA for a project (POST /api/v1/projects/{id}/query).", toolSchemas.search_creative_dna.shape, async (args) => runTool(authCtx, (c) => c.post(`/api/v1/projects/${encodeURIComponent(args.project_id)}/query`, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gloriginmind/mcp",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "OriginMind MCP server — dual-auth skill routes via Bootstrap OAuth API key",
   "type": "module",
   "bin": {
@@ -9,6 +9,21 @@
     "originmind-mcp-http": "dist/http.js"
   },
   "main": "./dist/stdio.js",
+  "exports": {
+    ".": "./dist/stdio.js",
+    "./server": {
+      "types": "./dist/tools.d.ts",
+      "import": "./dist/tools.js"
+    },
+    "./auth": {
+      "types": "./dist/auth.d.ts",
+      "import": "./dist/auth.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    }
+  },
   "files": [
     "dist",
     "README.md"