Summary
Turns Claude into a Socratic product partner that builds structured intent specs through conversation. Ask vague questions, get challenged on weak thinking, and end up with a complete spec saved as intent.md with YAML frontmatter covering objectives, outcomes, and edge cases. Runs entirely local with no API key required for the core Intent Compiler. Ships with seven auto-triggering skills for Claude Code that handle spec verification, issue splitting, and code review against intent outcomes. Exports specs to .cursorrules or CLAUDE.md so other AI agents in your project inherit the same context. Optional cloud mode with API key unlocks team features like dependency graph analysis, workspace strategy context, and intent status tracking across approved, shipped, and verified states.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →@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.
Links
- npm package: the published server, always current
- IntentSpec: the open specification for the
intent.mdfiles this server writes - The intent.md profile: the six checks
check_intent_readinessscores against - Pathmode: the platform for teams
- Listed in the MCP registry and on Smithery, which carries the same server as a local bundle that runs the build it ships instead of fetching from npm at launch
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
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Configuration
PATHMODE_API_KEYsecretOptional: Your Pathmode API key for team features (dependency graph, workspace context). Get one from Settings > API Keys in the Pathmode app.