For AI agents · MCP server

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

  1. 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.

  2. 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
  3. Step 3 · register with your MCP host

    Claude Desktop · ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%/Claude/claude_desktop_config.json on 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_alignment on 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_URL env var lets you point at a staging or self-hosted instance.
See the rest of the AI-agent surface on /agents · status at /status.