Primer MCP server
io.github.ivanlai/primer-mcp·v0.1.8A Jira-lite MCP server that guides planning-first workflows for AI-assisted development.
0 stars60 downloads/wk
Reviews
Write oneNobody has reviewed Primer yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Primer tools (17, 7 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
complete_spikeClose a spike by recording its findings — the answer to the question it was investigating and any recommendations. Works from any status.
complete_taskMark a task as completed with notes on what was done. The notes parameter is a terse one-liner for the frontmatter field; write a fuller summary (approach, key changes, decisions) into the ## Completion Notes body section of the ticket separately. Ideally call start_task first, but this works from any status. After this, call verify_task with evidence to finalise.
create_spikewrite actionCreate a Spike under a story — a timeboxed investigation to answer a specific question before committing to an implementation approach. The parent story must already exist. When done, call complete_spike with your findings.
create_storywrite actionCreate a Story under an epic — a deliverable with acceptance criteria. The epic must exist — if one hasn't been created yet, call plan_epic first. The user will have described their goals; use that to create the epic, asking for clarification if needed. If no ADR has been recorded, the response will suggest capturing decisions first, but the story is still created.
create_taskwrite actionCreate a Task under a story — a concrete unit of implementation work with a testable outcome. The parent story must already exist.
delete_ticketwrite actionDelete a ticket. Non-todo tickets are deleted with a warning. Children are reported but not deleted — call delete_ticket on each to cascade. After all deletions, call sweep_blocked_by to clean up dangling references. Recoverable from git history.
export_graphGenerate a self-contained HTML file visualising the project as an interactive graph. Opens in any browser with no external requests. Nodes are coloured by type and status; edges show both hierarchy (epic -> story -> task) and dependencies (blocked_by). Click a node to see its details. On-demand — call when you want a snapshot.
get_ticketRead one ticket by ID, with its full body. Also reports which tickets it blocks — that direction is not stored on the ticket itself, so this is the only way to see it.
init_projectInitialise this project for primer-mcp: creates the primer/ ticket store and adds the workflow section to CLAUDE.md and AGENTS.md, creating them if needed. Non-destructive and idempotent. Call this once per project, before any other tool. Optionally pass jira_project_key if tickets may later be exported to Jira.
list_actionableList what can be acted on right now, with epic context.
list_ticketsList tickets one per line, newest work last. Filter by type (epic, adr, story, task, spike), status, or parent_id (show only children of that ticket). Use this to find an ID before calling another tool.
plan_epicwrite actionCreate an Epic — the top-level container for a body of work. Start here: state why the work matters, its goals, and how you'll know it's done. Consider recording decisions (record_adr) before creating stories — it captures reasoning that gets lost once implementation starts.
record_adrRecord an Architecture Decision Record under an epic: the context forcing a choice, the decision, alternatives rejected (with reasons), and consequences accepted. Recording decisions before creating stories is recommended — it captures reasoning that gets lost once implementation starts.
start_taskTransition a task to in-progress — call this when you begin working on a task. Works from any status; you'll get a note if the transition is unusual. After finishing, call complete_task.
sweep_blocked_bywrite actionRemove blocked_by references that point to tickets that no longer exist. Call once after finishing a batch of delete_ticket calls.
update_ticketwrite actionAmend a ticket after creation; anything left out is left alone.
verify_taskVerify a task with evidence that the work holds (e.g. "218 passed, mypy clean"). Pass the short commit hash in the commit parameter so it is labelled consistently. Ideally call complete_task first to capture notes, but this works from any status. Sets the task to verified.
Public scan report
scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it
- Code scan16 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 32 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Primer compares
Against every graded Developer tools MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 88/100
- higher than 75% of 1,119 Developer tools servers
- Tools
- 17
- the typical Developer tools server has 7
- Tools that change things
- 41%
- typical: 5%. Fewer write tools means less an agent can break
- Downloads a week
- 60
- more than 44% of 436 Developer tools servers with a package
What its tools let an agent do: 9 read · 3 create · 3 change · 1 delete · 1 run or deploy
Release history: 3 versions in the registry since 2026-08-18, latest 2026-09-29, typically one every 41 days.
Install Primer in Claude Code, Cursor or VS Code
claude mcp add primer-mcp -- uvx primer-mcp
What the publisher says
From the Primer repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.ivanlai/primer-mcp -->
primer-mcp
Beta — the core workflow is stable and tested, but the tool is new. Expect rough edges.
A Jira-lite MCP server that guides planning-first workflows for AI-assisted development — tickets as markdown files, your AI agent as the interface.
Why
Getting real value from AI coding agents takes more than prompting — it takes shaping what they build, engineering the workflow around them, and deploying something that holds up in practice. Left to their own devices, agents jump straight to implementation. Primer-mcp makes them plan first: state why the work matters, record decisions and weigh trade-offs, break it into stories and tasks, then complete and verify each one. The tickets are plain markdown with YAML frontmatter, committed alongside your code — no external service, no database, fully visible in your repo and conveniently browsable with tools like Obsidian.
primer-mcp is designed for solo developers and small projects — one person (and their AI agent) working through a backlog. It doesn't have assignment, notifications, or multi-user coordination, and that's deliberate: it's a lightweight complement to the AI workflow, not a replacement for Jira.
Quick start
Requires Python 3.12+ and uv.
Add to your MCP client config (e.g. Claude Code settings.json, Claude Desktop claudedesktopconfig.json):
{
"mcpServers": {
"primer-mcp": {
"command": "uvx",
"args": ["primer-mcp"]
}
}
}That's it — your MCP client downloads and runs primer-mcp automatically. You don't need to install anything manually.
Tell your AI agent what you want to build — it handles the rest. The server guides the agent through a planning-first workflow: why the work matters, decisions, stories, tasks, completion. Not sure what to do next? Ask your agent — it reads the current state and knows what comes next.
Manual install (optional)
If you prefer to install primer-mcp as a standalone tool (e.g. for the list-actionable CLI command):
uv tool install primer-mcp
# Update to latest
uv tool upgrade primer-mcp
# Uninstall
uv tool uninstall primer-mcpWhat it looks like
A typical session — you describe the work, the agent handles the planning:
You: I want to add user authentication.
Agent: You have EP-001: "Launch the app" — auth fits under that.
Or I can create a separate epic if this is a bigger initiative.
You: EP-001 is fine.
Agent: Before we build, we should decide on the auth approach.
A few common options:
1. JWT with refresh tokens — stateless, good for mobile/SPAs
2. Server-side sessions — simple, but needs sticky storage
3. OAuth2 only — delegates to a provider, less to maintain
...
You: Option 1 — we need mobile support.
Agent: I'll record that decision so we don't revisit it later.
→ Recorded ADR-003: "Use JWT with refresh tokens"
Rejected: server-side sessions (no mobile support),
OAuth2 only (need local accounts too)
Breaking this into stories.
→ Created ST-005: "Login and registration endpoints"
→ Created ST-006: "Token refresh and revocation"
And tasks for the first story:
→ Created TK-010: "Add /register endpoint with validation"
→ Created TK-011: "Add /login endpoint returning JWT pair"
→ Created TK-012: "Write integration tests for auth flow"
You: Let's sShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Primer: common questions
- Is Primer MCP server safe?
- Yes, by our scan: it is graded A (88/100). Read the Primer safety report
- How do I install Primer?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Primer need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Primer maintained?
- The last commit was 33 days ago (2026-10-01). The latest release is v0.1.8.
- What can I use instead of Primer?
- Servers from other publishers that do the same job: Agent Harnesses MCP server, Atlassian Dc Jira MCP server and Atlassian Rovo MCP Server.
- How does Primer compare with other Developer tools MCP servers?
- safety score 88/100 (higher than 75% of 1,119 Developer tools servers); tools 17 (the typical Developer tools server has 7); tools that change things 41% (typical: 5%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Primer
Same job from other publishers: the closest match first, then the best rated.
- Agent HarnessesAgent-harness picks, decision guides, setup templates, and skills; live GitHub/HN discovery.not reviewedEstablishedA
- Atlassian Dc JiraMCP server for Atlassian Jira Data Center - search, view, and create issuesnot reviewedEstablishedB
- Atlassian Rovo MCP ServerConnect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.not reviewedEstablishedA
- Dot AIAI-powered development platform for Kubernetes deployments and intelligent automationnot reviewedEstablishedA
- KubefwdKubernetes port forwarding for local development with automatic /etc/hosts entries.not reviewedEstablishedA