MCP.so
Sign In

Pathmode MCP Server

@pathmodeio

Basic information

Category

Developer Tools

Transports

stdio

Author

pathmodeio

Submitted by

Janne Lammi

About Pathmode MCP Server

Deterministic preflight for the intent you hand to a coding agent: six calibrated gates, the exact blockers named, no model call, no key needed.

#intent-engineering#claude-code#agent-skills#ai-agents#mcp-server#product-development#preflight#intent-md#coding-agents

Pathmode MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Pathmode MCP Server tools

10

Get the currently active intent, with a summary of the evidence it cites.

List intents with their status and objectives.

Get one intent by ID with its objective, outcomes, constraints, and edge cases.

Search intents by keyword across goals, objectives, outcomes, and constraints.

Run the deterministic six-check preflight on an intent and name the exact blockers. No model call.

Save an intent spec to the repository's intent.md, and to the workspace when one is connected.

Adopt an existing OpenSpec change as intent.md without modifying the change folder.

Confirm a readiness check the preflight read but could not confirm, or waive it with a person's approval.

Record a person's explicit answer to one open product choice in the local intent.md.

Export an intent as .cursorrules, a CLAUDE.md or AGENTS.md section, an Outcomes rubric, or an OpenSpec change.

Overview

What is Pathmode?

Pathmode finds the product decisions a request leaves open, before your coding agent builds. It gives your agent check_intent_readiness, a deterministic preflight: six calibrated checks, no model call, the same verdict every run. Specs live in intent.md in your repository, as plain markdown you own, in the open IntentSpec format.

How to use Pathmode?

Add npx @pathmode/mcp-server to your MCP client config. No signup and no API key. Then ask your agent for a change the way you normally would. The server instructs it to run preflight first and, when the repository has no intent.md, to draft one, record the open product choices, and stop before changing code. These are instructions, not enforcement: whether an agent follows them is up to the agent. Optionally run npx @pathmode/mcp-server install-skills to add 9 Claude Code skills.

Key features of Pathmode

  • Deterministic preflight: checks for a specific title, an objective with an actor and a concrete problem, observable outcomes, a hard constraint, an edge case with its expected behavior, and a runnable check, and names the exact blockers
  • Open product choices: each recorded with a recommendation, the alternative, and what each costs; a person answers each one before implementation
  • Keyless local mode: nothing leaves the machine
  • Export to .cursorrules, CLAUDE.md, or AGENTS.md; import an existing OpenSpec change
  • 9 Claude Code skills that auto-trigger on natural-language requests
  • Optional Pathmode workspace: a reviewer outside the repository answers and authorizes the spec, and pull requests are graded against the agreed outcomes

Use cases of Pathmode

  • Checking a ticket for undecided product behavior before an agent implements it
  • Drafting an intent.md for a change, with open choices recorded instead of guessed
  • Recording a person's explicit answer to each open choice in the spec
  • Stress-testing an existing spec, or splitting it into Linear, Jira, or GitHub Issues tickets
  • Reviewing code changes against the spec's outcomes

Frequently asked questions

1

Does Pathmode need an account or an API key?

No. Local mode is the default: specs live in `intent.md` and nothing leaves the machine. The preflight makes no model call.

2

What does a passing preflight mean?

That the spec is specific enough to hand to an agent. It reads text against a fixed vocabulary, so it cannot tell you the decision is right. Any open product choice still blocks until a person answers it.

3

How do I connect a team workspace?

From a repository with an `intent.md`, run `npx @pathmode/mcp-server@latest adopt` and give the printed link and code to the person connecting the repository. They choose a workspace and approve in the browser. No spec content leaves the machine until approval.

4

What transport does Pathmode use?

stdio, via `npx @pathmode/mcp-server`. Local mode needs no authentication; a connected workspace uses the key issued during `adopt`.

Comments

More Developer Tools MCP servers