Developer Documentation

XandaCross MCP

Connect AI agents to a private brain, then decide whether information belongs as a searchable page or as a lightweight saved memory.

Quick Start

For first-time setup, run codex mcp add. If it already says Successfully logged in, do not immediately run codex mcp login; that can start a second OAuth authorization.

codex mcp add xandacross \
  --url https://xandacross.himeshbhowmik.com/mcp

codex mcp list

Use codex mcp login xandacross later only when credentials are missing, expired, revoked, or after an intentional logout.

Practical Guide

Knowledge Graph vs Memories

Simple rule: if it needs a title, slug, citations, or graph browsing, use put_page. If it is a short reusable note from a conversation, use zen_memory_save.

Use case	Best place	Why	Command/tool
Project documentation, policies, specs, meeting notes	Knowledge Graph	Needs titles, slugs, chunks, citations, and full-page retrieval.	put_page, zen_search, zen_query, get_page
A decision from a Codex conversation	Memories	Short reusable context, not a full document.	zen_memory_save, zen_memory_recall
User preferences and working style	Memories	Agents can recall preferences without searching long pages.	zen_memory_save
Evidence for an answer	Knowledge Graph	Search returns page and chunk metadata for citations.	zen_search or zen_query
Quick project reminders	Memories	Easy to save and recall by scope/project.	zen_memory_save
Canonical company knowledge	Knowledge Graph	It should appear as pages and graph nodes for browsing.	put_page

Commands and Tools

get_zen_identity

Read-only

Check authorized brain, engine, page count, and chunk count.

sources_list

Read-only

List available sources/pages for the authorized brain.

zen_search

Read-only

Search indexed pages and chunks.

zen_query

Read-only

Advanced search over indexed knowledge.

get_page

Read-only

Fetch a full page by slug.

get_chunks

Read-only

Fetch chunk-level evidence for a page.

zen_memory_save

Write

Save a short durable fact, decision, or preference.

zen_memory_recall

Read-only

Search saved memories/facts.

put_page

Write

Create or update a knowledge page with a slug.

Examples

Save company/project documentation as a page

Use the xandacross MCP server.
Create a knowledge page using put_page.
Slug: handbook/mcp-setup
Content:
MCP Setup Rule
Developers should run codex mcp add xandacross --url https://xandacross.himeshbhowmik.com/mcp for first-time setup.
Use codex mcp login xandacross only later for re-authentication.
Do not modify anything else.

Save a short project memory

Use the xandacross MCP server.
Save this memory using zen_memory_save:
"Project update: Codex MCP first-time setup should use codex mcp add only. Run codex mcp login only when credentials are missing, expired, revoked, or after logout."
Scope it to project if supported.
Project: IBrain.
Do not save secrets, tokens, callback URLs, authorization codes, or private OAuth credentials.

Search documents

Use the xandacross MCP server.
Search my knowledge using zen_search.
Query: MCP authorization duplicate connection
Return the page title, source_id, page/chunk information, and a short excerpt.
Read-only.

Recall memories

Use the xandacross MCP server.
Recall saved memories using zen_memory_recall.
Query: MCP setup command
Project: IBrain
Limit: 5
Read-only.

Security

XandaCross uses OAuth with PKCE. A connected MCP client receives access only to the brain selected by the user. Revoking a client removes its active token access.