@theronap/cortex-mcp 0.1.0

package/README.md

@@ -0,0 +1,37 @@
+# cortex-mcp
+
+Connect your AI assistant to **Cortex** — your org's projects, recent activity, gaps, and directives, scoped to exactly what you're permitted to see.
+
+## Setup
+
+1. Get your personal token from the Cortex console → **Connect your AI**.
+2. Add this to your Claude Code config (`~/.claude.json`, under `mcpServers`):
+
+```json
+{
+  "mcpServers": {
+    "cortex": {
+      "command": "npx",
+      "args": ["-y", "@theronap/cortex-mcp"],
+      "env": { "CORTEX_TOKEN": "your-personal-token" }
+    }
+  }
+}
+```
+
+3. Restart Claude Code. Your AI now sees your org context automatically.
+
+No clone, no path, no build step — `npx` fetches and runs it.
+
+## Tools
+
+- **my_context** — your projects, recent activity, gaps, and directives.
+- **search_org** — search your visible activity and projects by keyword.
+- **project_status** — status of a specific project by key.
+
+## Environment
+
+| Var | Required | Default |
+|-----|----------|---------|
+| `CORTEX_TOKEN` | yes | — |
+| `CORTEX_URL` | no | `https://cortex-console.vercel.app` |

package/bin/cortex-mcp.mjs

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+/**
+ * cortex-mcp — connect your AI assistant to Cortex.
+ *
+ * Zero-install usage. Add to your Claude Code config (~/.claude.json mcpServers):
+ *
+ *   "cortex": {
+ *     "command": "npx",
+ *     "args": ["-y", "cortex-mcp"],
+ *     "env": { "CORTEX_TOKEN": "<your-personal-token>" }
+ *   }
+ *
+ * Get your CORTEX_TOKEN from the Cortex console → Connect your AI.
+ *
+ * Env:
+ *   CORTEX_TOKEN  (required) your personal token — identifies you + your org
+ *   CORTEX_URL    (optional) defaults to https://cortex-console.vercel.app
+ */
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
+import { z } from 'zod'
+
+const VERSION = '0.1.0'
+const arg = process.argv[2]
+if (arg === '--version' || arg === '-v') { process.stdout.write(`cortex-mcp ${VERSION}\n`); process.exit(0) }
+if (arg === '--help' || arg === '-h') {
+  process.stdout.write(
+    `cortex-mcp ${VERSION} — connect your AI assistant to Cortex\n\n` +
+    `Set CORTEX_TOKEN (from the Cortex console → Connect your AI) and run via your\n` +
+    `MCP client. Optional CORTEX_URL overrides the API base.\n\n` +
+    `Claude Code config:\n` +
+    `  "cortex": { "command": "npx", "args": ["-y", "cortex-mcp"],\n` +
+    `              "env": { "CORTEX_TOKEN": "..." } }\n`
+  )
+  process.exit(0)
+}
+
+const TOKEN = process.env.CORTEX_TOKEN
+const BASE = (process.env.CORTEX_URL ?? 'https://cortex-console.vercel.app').replace(/\/$/, '')
+
+if (!TOKEN) {
+  process.stderr.write('cortex-mcp: CORTEX_TOKEN is required. Get yours from the Cortex console → Connect your AI.\n')
+  process.exit(1)
+}
+
+// Cache context for 5 minutes so repeated tool calls don't re-fetch.
+let cache = null
+async function fetchContext() {
+  const now = Date.now()
+  if (cache && now - cache.ts < 5 * 60 * 1000) return cache.text
+  const res = await fetch(`${BASE}/api/mcp-context`, { headers: { Authorization: `Bearer ${TOKEN}` } })
+  if (!res.ok) {
+    let detail = 'unknown'
+    try { detail = (await res.json()).error ?? detail } catch { /* ignore */ }
+    throw new Error(`Cortex API ${res.status}: ${detail}`)
+  }
+  const { context } = await res.json()
+  cache = { text: context, ts: now }
+  return context
+}
+
+const server = new McpServer({ name: 'cortex', version: VERSION })
+
+server.registerTool(
+  'my_context',
+  {
+    title: 'My Cortex context',
+    description: 'Your current work context from the org — your projects, recent activity, gaps, and any directives from leadership. Scoped to what you are permitted to see.',
+    inputSchema: {},
+  },
+  async () => ({ content: [{ type: 'text', text: await fetchContext() }] }),
+)
+
+server.registerTool(
+  'search_org',
+  {
+    title: 'Search the org',
+    description: 'Search your visible work activity and projects by keyword.',
+    inputSchema: { query: z.string().describe('keyword to search for') },
+  },
+  async ({ query }) => {
+    const text = await fetchContext()
+    const q = query.toLowerCase()
+    const lines = text.split('\n').filter((l) => l.toLowerCase().includes(q))
+    return { content: [{ type: 'text', text: lines.length ? `Matches for "${query}":\n${lines.join('\n')}` : `No visible results for "${query}".` }] }
+  },
+)
+
+server.registerTool(
+  'project_status',
+  {
+    title: 'Project status',
+    description: 'Status of a specific project by key (e.g. checkout-v2). Returns only what you can see.',
+    inputSchema: { key: z.string().describe('project key, e.g. checkout-v2') },
+  },
+  async ({ key }) => {
+    const text = await fetchContext()
+    const line = text.split('\n').find((l) => l.includes(`**${key}**`) || l.includes(key))
+    return { content: [{ type: 'text', text: line ? `Project ${key}:\n${line.trim()}` : `No visible project "${key}".` }] }
+  },
+)
+
+await server.connect(new StdioServerTransport())

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@theronap/cortex-mcp",
+  "version": "0.1.0",
+  "description": "Connect your AI assistant to Cortex — your org's projects, activity, gaps, and directives, scoped to you.",
+  "type": "module",
+  "bin": {
+    "cortex-mcp": "bin/cortex-mcp.mjs"
+  },
+  "files": [
+    "bin"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.23.8"
+  },
+  "keywords": ["mcp", "cortex", "claude", "ai", "org-intelligence"],
+  "license": "MIT"
+}