English Français العربية

io.github.pathmodeio/mcp-server

Official registry AI and agents

Deterministic intent preflight before your agent builds: six gates, keyless, no model call.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @pathmode/mcp-server
Claude Code 
claude mcp add io-github-pathmodeio-mcp-server -e 'PATHMODE_API_KEY=<your pathmode_api_key>' -- npx -y @pathmode/mcp-server@1.43.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "io-github-pathmodeio-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@pathmode/mcp-server@1.43.3"
            ],
            "env": {
                "PATHMODE_API_KEY": "<your pathmode_api_key>"
            }
        }
    }
}

Environment variables

  • PATHMODE_API_KEY secret Optional: Your Pathmode API key for team features (dependency graph, workspace context). Get one from Settings > API Keys in the Pathmode app.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @pathmode/mcp-server
  2. Install
  3. See it work
  4. Links
  5. Issues
  6. License

@pathmode/mcp-server

Find the product decisions a request leaves open, before your coding agent builds. A deterministic preflight: six calibrated checks, keyless, no model call.

This repository dogfoods the same workflow: read its intent.md.

This repository is the issue tracker for the package, not its source. The server is developed in Pathmode's private monorepo and published to npm from there. This repo previously held a hand-copied snapshot of the source, which drifted several versions behind the published package. It no longer carries that copy, so there is nothing here to read out of date.

To read the code, unpack the published tarball:

npm pack @pathmode/mcp-server && tar -xzf pathmode-mcp-server-*.tgz

Install

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "pathmode": {
      "command": "npx",
      "args": ["@pathmode/mcp-server"]
    }
  }
}

No account and no API key. Specs live in intent.md in your repo, as plain markdown you own. Set PATHMODE_API_KEY to sync intent and evidence across a team.

See it work

Given one instruction, implement FN-412, in Fieldnote (a fictional billing app whose ticket asks for a Cancel plan button), an agent with this server wrote no product code. It found that the only cancel code in the repository was written for refunds and would take paid days away from every customer who cancels, drafted an intent.md with four open product choices, and stopped: preflight passed 6/6, still blocked by those choices. The recorded run lists every tool call, and npx -y @pathmode/cli preflight on that branch reproduces the verdict.

Issues

Bug reports and feature requests belong in Issues. Include the output of npx @pathmode/mcp-server --version and the client you are running.

License

MIT

Frequently asked questions

What is io.github.pathmodeio/mcp-server?

Deterministic intent preflight before your agent builds: six gates, keyless, no model call.

How do I install io.github.pathmodeio/mcp-server?

It runs on your machine. In Claude Code: claude mcp add io-github-pathmodeio-mcp-server -e 'PATHMODE_API_KEY=<your pathmode_api_key>' -- npx -y @pathmode/mcp-server@1.43.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.pathmodeio/mcp-server need an API key?

Yes. It expects PATHMODE_API_KEY, which you set in its configuration.

Is io.github.pathmodeio/mcp-server open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.pathmodeio/mcp-server?

It is published by pathmodeio. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.