Yeti, an MCP server that guides product design from requirements to Jira
Macorifice released Yeti, a local SQLite-backed MCP server that guides Claude Desktop through five design phases and syncs verified scopes directly into Jira.
By Dillip Chowdary • Oct 25, 2026 • Source: github.com

At a glance
- Product
- Yeti 1.0.0, open-source MCP server
- Requires
- Node.js 22.13 or newer with native SQLite
- Storage
- Native node:sqlite; imports data/db.json on first run
- Jira
- push_to_jira defaults to dry-run
In this post
Macorifice released Yeti, an open-source Model Context Protocol server connecting Claude Desktop to local product design workflows and Jira tracking. As detailed in github.com's report, the utility guides projects from problem discovery to verified scopes. Running on Node.js 22.13 or newer with native SQLite, Yeti directs Claude through user stories, RICE scoring, and Mermaid flow diagrams before publishing tickets.
This report examines the architecture, tools, phase constraints, and configuration introduced in Yeti 1.0.0. Geared for technical product managers and engineers using Claude Desktop, it details how conversational prompts convert into MoSCoW requirements and exportable backlogs, covering installation, local dashboard monitoring, and Jira synchronization rules.
01What actually changed
With the stable 1.0.0 release, Macorifice moved Yeti to the native node:sqlite module in Node.js 22.13, replacing the earlier data/db.json storage format. On its first run, the updated server automatically imports data from data/db.json and leaves that file untouched.
When adding Yeti to claude_desktop_config.json via npx, operators must set PRODUCT_DESIGN_DB to a permanent path like data/yeti.sqlite. Because npx package caches can clear unpredictably, isolating the SQLite file outside transient directories protects requirements, stories, and summaries from unintended deletion during routine system cleanups.
The dashboard binds strictly to 127.0.0.1, refuses requests targeting other hostnames, and polls the SQLite database every ten seconds. It renders flow diagrams using Mermaid loaded from a content delivery network, falling back to plain text offline. In addition, export_dashboard writes a static snapshot directly to data/exports/dashboard.html for sharing across teams.
The dashboard binds strictly to 127.0.0.1, refuses requests targeting other hostnames, and polls the SQLite database every ten seconds. It renders flow diagrams using Mermaid loaded from a content delivery network, falling back to plain text offline. In addition, export_dashboard writes a static snapshot directly to data/exports/dashboard.html for sharing across teams.
02How it works
The definition phase requires adding MoSCoW requirements and linking user stories with acceptance criteria. Next, prioritization ranks concepts by computing and sorting user-entered RICE scores, while flows uses map_user_flow for Mermaid branching diagrams. Finally, verification confirms every must requirement is marked complete and covered by an active user story before the project closes.
The definition phase requires adding MoSCoW requirements and linking user stories with acceptance criteria. Next, prioritization ranks concepts by computing and sorting user-entered RICE scores, while flows uses map_user_flow for Mermaid branching diagrams. Finally, verification confirms every must requirement is marked complete and covered by an active user story before the project closes.
Execution is governed by strict and free modes. In default strict mode, advance_phase halts transitions when items are missing, reporting exact omissions.
In free mode, phases advance regardless while listing skipped elements. Items can be edited, searched, duplicated as project templates, or exported as Markdown or CSV to data/exports/.
When exporting work, push_to_jira defaults to dry-run mode, creating Jira Tasks for requirements and Stories for user stories. Downstream, sync_from_jira marks matching Yeti items completed or reopened according to Jira status while leaving manually closed items untouched.
Advertisement
Tech Pulse Daily
Get tomorrow's pulse first
Join engineers who read Tech Pulse before stand-up. Free, weekday mornings.
03Why it matters now
Instead of allowing conversational assistants to generate unverified task lists, Yeti requires ideas to pass through MoSCoW prioritization and user story mapping. Because prioritize_rice sorts manually entered numerical values rather than generating speculative estimates, human operators retain control over priority scores. This framework converts conversational prompts into auditable specifications before engineering tasks reach external boards.
Instead of allowing conversational assistants to generate unverified task lists, Yeti requires ideas to pass through MoSCoW prioritization and user story mapping. Because prioritize_rice sorts manually entered numerical values rather than generating speculative estimates, human operators retain control over priority scores. This framework converts conversational prompts into auditable specifications before engineering tasks reach external boards.
External networking occurs exclusively through push_to_jira, which demands JIRA_SITE, JIRA_EMAIL, and JIRA_API_TOKEN environment variables. If these credentials are missing, the tool halts remote transmission while continuing to support local dry-run previews. Furthermore, displaying Jira links on the local dashboard when JIRA_SITE is supplied gives product teams immediate visibility across design artifacts and development tickets.
External networking occurs exclusively through push_to_jira, which demands JIRA_SITE, JIRA_EMAIL, and JIRA_API_TOKEN environment variables. If these credentials are missing, the tool halts remote transmission while continuing to support local dry-run previews. Furthermore, displaying Jira links on the local dashboard when JIRA_SITE is supplied gives product teams immediate visibility across design artifacts and development tickets.
04Who is affected
Technical product managers and system designers using Claude Desktop gain formal guardrails for scoping complex initiatives. Teams can duplicate existing projects via duplicate_project to reuse proven requirement and story patterns as templates.
For teams with existing backlogs, import_requirements ingests CSV data exported by export_backlog, though story links must be reconnected manually after import. Engineering leads benefit from the verification phase gate, which prevents unfinished requirements from prematurely reaching active engineering queues, ensuring that every critical feature has validated user stories and completed acceptance criteria before implementation begins.
Jira administrators and engineering teams maintain standard board operations because Yeti intentionally avoids implementing a duplicate task board. Active execution belongs in Jira, while Yeti confines its dashboard to design progress.
When dispatching tickets, push_to_jira includes a limit parameter to send controlled subsets and an update option to refresh previously linked tickets. Remote sync maintains board alignment through sync_from_jira, which reads Jira issue states, automatically marking completed tickets done in Yeti while reopening tickets if status regresses, without overriding items that operators manually marked complete.
05What to watch
Organizations adopting Yeti must establish proper local storage hygiene and environment variable configurations. Running the server requires Node.js 22.13 or newer, whether built from source using npm run build targeting dist/index.js or executed through npx yeti-mcp.
Operators must persistently set PRODUCT_DESIGN_DB in shell configuration files to ensure the SQLite database is never placed within temporary caches that clear automatically. Teams must also recognize that while local database records remain private, requirement text passes through the Claude conversational interface, meaning sensitive company secrets or internal credentials must be kept out of chat prompts.
Development teams should evaluate the Mastro case study provided in the repository to observe how requirement gates and Jira sync cycles function in practice. Test suites executed via npm test allow engineers to validate phase transitions and tool operations against temporary databases before committing to production planning workflows. As teams choose between strict gating and free iteration, monitoring how well the local dashboard maintains visibility over MoSCoW priorities, Mermaid diagrams, and RICE leaders will indicate whether Model Context Protocol servers can permanently bridge the gap between conversational AI design and enterprise issue trackers.
Frequently asked questions
What runtime version is required to run Yeti?
Yeti requires Node.js 22.13 or later because it relies on the built-in node:sqlite module for local database operations.
How does Yeti prevent data loss when installed through npx?
Operators must set the PRODUCT_DESIGN_DB environment variable to a persistent directory, which prevents the SQLite database file from being stored in temporary package caches that can clear unexpectedly.
What are the five phases of a Yeti project?
A project moves in sequence through discovery, definition, prioritization, flows, and verification. In default strict mode, the project cannot advance to the next phase until all required items and story coverage gates are satisfied.
Which environment variables are required to push issues to Jira?
Exporting tickets requires JIRA_SITE, JIRA_EMAIL, and JIRA_API_TOKEN. Without these variables configured in the environment, push_to_jira blocks external network calls but still allows local dry-run previews.
Sources
Author
Dillip Chowdary
Writes Tech Bytes coverage of AI, engineering, and the tools that actually ship. Editor of Tech Pulse Daily.
Related on Tech Bytes
Advertisement