@theronap/cortex-mcp 0.9.22 → 0.9.23

package/lib/server.mjs

@@ -242,6 +242,47 @@ export async function runServer(version) {
     },
   )
 
+  server.registerTool(
+    'read_page',
+    {
+      title: 'Read a wiki page in full',
+      description:
+        'READ the full authored wiki page for one node (project/person/org/you) by its canonical name — every section, every tier you can see. This is how you READ a node; `grep` only LOCATES pages (snippets + their [[links]]), it does not read them. Navigate like a researcher: read the page you need, then FOLLOW its inline [[links]] by calling read_page on each linked name — keep following while the linked pages stay relevant, stop when they do not. You decide how deep to go. Returns only what you are permitted to see.',
+      inputSchema: {
+        name: z.string().describe('the canonical node name exactly as written (e.g. "Cortex", "Ben", or a [[link]] target)'),
+        kind: z.enum(['project', 'person', 'org', 'user']).optional().describe('node kind (default project; pass person/org for people/teams)'),
+      },
+    },
+    async ({ name, kind }) => {
+      const k = kind ?? 'project'
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/brain/page?kind=${k}&key=${encodeURIComponent(name)}`,
+          { headers: { Authorization: `Bearer ${TOKEN}` } })
+      } catch (e) {
+        return { content: [{ type: 'text', text: `Could not read "${name}": ${e.message}` }] }
+      }
+      if (res.status === 404) {
+        return { content: [{ type: 'text', text: `No ${k} page named "${name}". If it's a person or team, pass kind (person/org). Otherwise \`grep "${name}"\` to locate it — it may be a red-link (a wanted page that isn't authored yet).` }] }
+      }
+      if (!res.ok) {
+        const d = classify(res.status, res.headers.get('content-type'), await res.text(), res.headers.get('x-vercel-id'))
+        return { content: [{ type: 'text', text: `Could not read "${name}": ${d.message}` }] }
+      }
+      const page = await res.json()
+      if (!page?.authored || !Array.isArray(page.tiers) || !page.tiers.length) {
+        return { content: [{ type: 'text', text: `"${name}" (${k}) exists but has no authored page yet — nothing to read. Try \`grep\` for mentions or \`story\` for a records-derived narrative.` }] }
+      }
+      const day = (d) => (d ? String(d).slice(0, 10) : '')
+      const blocks = page.tiers.map((t) => {
+        const secs = (t.sections ?? []).map((s) => `### ${s.heading}\n${s.body}`).join('\n\n')
+        const head = `[${t.tier}${day(t.updated_at) ? ` · authored ${day(t.updated_at)}` : ''}${t.validity && t.validity !== 'current' ? ` · ${t.validity}` : ''}]`
+        return [head, t.summary, secs].filter(Boolean).join('\n')
+      })
+      return { content: [{ type: 'text', text: `# ${page.title ?? name} (full authored page)\n\n${blocks.join('\n\n---\n\n')}\n\n— Follow any [[links]] above with read_page to go deeper.` }] }
+    },
+  )
+
   server.registerTool(
     'story',
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theronap/cortex-mcp",
-  "version": "0.9.22",
+  "version": "0.9.23",
   "description": "Connect your AI assistant to Cortex — your org's projects, activity, gaps, and directives, scoped to you.",
   "type": "module",
   "bin": {