Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PATHFINDER_HOST | No | SSE server host | 127.0.0.1 |
| PATHFINDER_PORT | No | SSE server port | 8080 |
| PATHFINDER_TRANSPORT | No | Transport: stdio or sse | stdio |
| PATHFINDER_MAX_TOKENS | No | Max context tokens | 128000 |
| PATHFINDER_SESSIONS_DIR | No | Session storage path | ~/.pathfinder-sessions |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| health_check | Check server health and return status. |
| start_research | Start a new research session. Args: task_description: Description of the task to research session_id: Optional session ID (auto-generated if not provided) |
| save_research | Save research findings to the session. Args: session_id: Session ID findings: Research findings to save |
| start_plan | Transition from research to plan phase. Creates plan.md template. Requires research to be complete. Args: session_id: Session ID |
| save_plan | Save implementation plan. Validates plan follows Cursor plan format with YAML frontmatter. Args: session_id: Session ID plan_content: Plan content in Cursor plan format |
| implement_phase | Execute an implementation phase from the plan. Args: session_id: Session ID phase_number: Specific phase to execute (defaults to next uncompleted) |
| compact_context | Compress session context into summary artifacts. Use when context utilization exceeds 60%. Args: session_id: Session ID |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| generate_plan_from_research | Generate an implementation plan from research findings. Args: session_id: Session ID with completed research |
| compact_session | Generate a compressed session summary. |
| resume_session | Generate context to resume a session. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| research_template | Research phase markdown template. |
| plan_template | Plan phase markdown template. |
| implementation_checklist | Implementation verification checklist template. |
| progress_template | Progress tracking markdown template. |