MCP.Market

Primer MCP server

by ivanlai·io.github.ivanlai/primer-mcp·v0.1.8

A Jira-lite MCP server that guides planning-first workflows for AI-assisted development.

A88/100grade A
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
New

0 stars60 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • complete_spike

    Close a spike by recording its findings — the answer to the question it was investigating and any recommendations. Works from any status.

  • complete_task

    Mark 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 action

    Create 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 action

    Create 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 action

    Create a Task under a story — a concrete unit of implementation work with a testable outcome. The parent story must already exist.

  • delete_ticketwrite action

    Delete 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_graph

    Generate 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_ticket

    Read 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_project

    Initialise 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_actionable

    List what can be acted on right now, with epic context.

  • list_tickets

    List 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 action

    Create 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_adr

    Record 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_task

    Transition 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 action

    Remove blocked_by references that point to tickets that no longer exist. Call once after finishing a batch of delete_ticket calls.

  • update_ticketwrite action

    Amend a ticket after creation; anything left out is left alone.

  • verify_task

    Verify 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

no findings
  • 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
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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-mcp

What 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 s

Shortened. 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 Harnesses
    Agent-harness picks, decision guides, setup templates, and skills; live GitHub/HN discovery.
    A
  • Atlassian Dc Jira
    MCP server for Atlassian Jira Data Center - search, view, and create issues
    B
  • Atlassian Rovo MCP Server
    Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
    A
  • Dot AI
    AI-powered development platform for Kubernetes deployments and intelligent automation
    A
  • Kubefwd
    Kubernetes port forwarding for local development with automatic /etc/hosts entries.
    A