One file. Your agent gets your alignment context.
pathnav-mcp.mjs is a zero-dependency Model Context Protocol server. Drop it into Claude Desktop, Cursor, or any MCP-aware host. Your agent automatically calls get_alignmentwhen relevant — pillars, vision, active goals, drains, current focus — and stays on plan instead of optimizing for whatever's in the latest prompt.
Install · 3 steps
- Step 1 · mint a token
Open Settings → Alignment for AI agents and mint a token with a memorable name (e.g. Claude Desktop). Copy the
pna_…value · it's shown once. PathNav stores only a hash. - Step 2 · save the script
Save pathnav-mcp.mjs somewhere stable (e.g.
~/.local/bin/pathnav-mcp.mjs). Source is small enough to read in 2 minutes; zero npm deps.Alternative · curl directly:
curl -L https://raw.githubusercontent.com/TaylorAmarelTech/pathnav/production/mcp/pathnav-mcp.mjs -o pathnav-mcp.mjs
- Step 3 · register with your MCP host
Claude Desktop ·
~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS,%APPDATA%/Claude/claude_desktop_config.jsonon Windows:{ "mcpServers": { "pathnav": { "command": "node", "args": ["/absolute/path/to/pathnav-mcp.mjs"], "env": { "PATHNAV_TOKEN": "pna_..." } } } }Cursor · Settings → MCP → Add server, same JSON shape.
Restart the host. Your agent now sees three tools and will call
get_alignmenton its own when relevant.
Tools the agent gains
- get_alignment
Full JSON · pillars, vision, goals + milestones, drains (anti-goals), parked, projects, habits, current focus.
- get_alignment_markdown
Same data as a markdown brief. Prefer this when the agent needs to quote your plan back to you.
- health
Sanity check · verifies the token + PathNav reachability.
Privacy & control
- The token is the only authentication. Treat it like a password.
- Outbound HTTPS only to PathNav · no telemetry, no third-party services.
- Revoke any time from the same settings panel. The next request the agent makes will fail with 401.
PATHNAV_BASE_URLenv var lets you point at a staging or self-hosted instance.