{"name":"io.github.SorcRR/hiveship-mcp-server","slug":"sorcrr-hiveship-mcp-server","title":null,"description":"MCP server for AI coding agents to interact with the Hiveship issue tracker","url":"https://mcp.market/server/sorcrr-hiveship-mcp-server","rating":null,"grade":"C","score":55,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":8,"stars":null,"forks":null,"downloads_week":8,"last_push_at":null,"license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/SorcRR/HiveShip","website":"https://hiveship.app/docs/agents/mcp","version":"0.7.0","remotes":[],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"@hiveship/mcp-server","version":"0.7.0","runtimeHint":"npx","transport":{"type":"stdio"},"environmentVariables":[{"description":"Base URL of the Hiveship API, e.g. https://hiveship.app/api","isRequired":true,"name":"HIVESHIP_API_URL"},{"description":"Bearer token — agent token (hsa_...) or personal access token (hsp_...)","isRequired":true,"isSecret":true,"name":"HIVESHIP_API_TOKEN"},{"description":"Default workspace id. Required for agent tokens and scoped PATs; optional for spanning PATs.","name":"HIVESHIP_WORKSPACE_ID"},{"description":"Base URL of the Hiveship web app, used for deep links in tool output. Defaults to a value derived from HIVESHIP_API_URL.","name":"HIVESHIP_WEB_URL"}]}],"tools":[{"name":"add_comment","description":"Add a comment to an issue","write_action":false,"price_micros":0,"input_schema":null},{"name":"configure","description":"Save Hiveship preferences for this machine, or record that the user declined. Preferences only \\u2014 never send a token here; the API token comes from the environment and must not be written to a config file. Pass `skip: true` to record a decline so the user is not asked again.","write_action":false,"price_micros":0,"input_schema":null},{"name":"create_issue","description":"Create a new issue. Server defaults: status BACKLOG, priority NONE. Session-scoped agent tokens can only create into the workspace triage Inbox (find its id via list_projects with includeInbox: true); workspace-scoped tokens can create anywhere.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_project_update","description":"Post a project status update \\u2014 a health snapshot + markdown note on the project timeline; also stamps the project's current health. Check list_project_updates first so the note reflects real change. Requires the write:projects PAT scope.","write_action":true,"price_micros":0,"input_schema":null},{"name":"execute_custom_view","description":"Run a saved view: return the issues matching its persisted filters (same output as list_issues). Paginated. Find view ids via list_custom_views. Requires the PRO+ custom-views plan feature.","write_action":true,"price_micros":0,"input_schema":null},{"name":"get_agent_session_activity","description":"Get the chronological activity feed for one agent session (thoughts, tool calls, elicitations, responses, errors). Cursor-paginated, oldest-first within the page; pass the returned cursor back to load more.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_guidance","description":"Get agent guidance for the workspace \\u2014 conventions, PR checklists, review rules a team configured. Read this before starting work; pass projectId once you know which project the issue belongs to for project-specific guidance too.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_issue","description":"Get detailed info about a specific issue","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_issue_context","description":"Full pre-work briefing for one issue in a single call: the issue core (status, assignee, linked PRs), its most recent comments, and its recent agent activity. Use this BEFORE starting work on an issue; use the lighter get_issue for a quick look.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_my_queue","description":"The calling agent's own work queue \\u2014 issues delegated to you, oldest first (FIFO); poll it to find waiting work. Requires an agent bearer token (hsa_); PAT-authenticated servers get a 403 \\u2014 use list_issues / list_agent_sessions instead.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_playbook","description":"Fetch a single playbook by name and return its full step-by-step body. Use list_playbooks first to discover available names.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_project_insights","description":"Analytics for a single project: burndown (remaining-issue series + agent/human completion split), velocity per sprint, and cycle-time percentiles (p50/p75/p95) with agent-vs-human medians. Requires the insights plan feature.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_setup_status","description":"Report whether this machine has saved Hiveship preferences, which values are set, and where they came from. Call this if you are unsure whether to run setup.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_workspace_insights","description":"Workspace-wide analytics: agent-vs-human work share, weekly throughput, open-issue load per assignee, agent-ops health (run-failure + PR-merge rates), and what needs attention (stale/unassigned issues, open PRs). Optional from/to bound the window. Requires the insights plan feature.","write_action":false,"price_micros":0,"input_schema":null},{"name":"link_pr","description":"Link a pull request to an issue after opening it \\u2014 the PR shows on the issue page and, while open, the review queue. One-directional: if the PR description does not already carry the issue URL, edit it in too. Idempotent: re-linking the same provider + number refreshes it. Agent tokens need a live session on the issue.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_agent_sessions","description":"List agent work sessions (live + historical) with status, token usage, and model. Filter by status or agentId; paginated. Use get_agent_session_activity to see what a specific session actually did.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_comments","description":"List an issue\\u2019s comment thread (author, date, body; one level of replies nested), oldest first. Long bodies are truncated with an explicit marker; raise limit for more.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_custom_views","description":"List the calling user's saved views (issue filters) for a project \\u2014 each view\\u2019s name, id, and filters. Run one with execute_custom_view. Requires the PRO+ custom-views plan feature.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_issues","description":"List issues in a project. Optional filters: status/priority/assignee/label arrays, sprint (or currentSprint), delegateType (HUMAN vs AGENT), date ranges, free-text query, sorting; paginated.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_labels","description":"List all labels in a Hiveship workspace. Labels can be attached to issues via update_issue.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_members","description":"List the human members of a workspace with their role (OWNER / ADMIN / MEMBER / VIEWER). Use the returned `user id` when assigning an issue to a person via update_issue. (Email is not exposed to agent callers.)","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_notifications","description":"List the calling user's notifications in a workspace (issue assignments, status changes, comment replies, agent-session outcomes, PR links). Pass `type: \"COMMENT_REPLY\"` to see only mentions/replies, or `unreadOnly: true` for the unread inbox.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_playbooks","description":"List the named playbooks configured for a Hiveship workspace \\u2014 reusable, versioned conventions a team saved (e.g. \"how we fix flaky tests here\"). Returns each playbook name, its \"when to use\" hint, and version, but NOT the body. Fetch a full playbook with get_playbook once you know its name.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_project_updates","description":"Read a project status-update timeline (newest first). Use this before posting a new update so the draft reflects what actually changed since the last one. Long update bodies are truncated with an explicit marker; raise limit for more.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_projects","description":"List the projects in a Hiveship workspace (paginated). Pass includeInbox: true to also surface the triage Inbox (hidden by default) when you need its id to file triage issues.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_recent_activity","description":"List the workspace audit feed \\u2014 who did what (including which MCP tool or agent acted) and the entity touched. Answers \"what changed recently\". Requires an OWNER or ADMIN PAT.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_sprints","description":"List sprints in a project (planning, active, and completed) with issue + story-point completion counts. Pass `currentOnly: true` to get just the active sprint. Requires the PRO+ sprint-management plan feature.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_workflow_statuses","description":"List the workflow statuses available in a workspace (e.g. BACKLOG / TODO / IN_PROGRESS / DONE plus any custom statuses). Use the returned `value` as the `status` argument when creating, updating, or filtering issues.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_workspaces","description":"List the workspaces the current user belongs to (ids, names, plan tier, member/agent counts). Use the returned `id` as `workspaceId` for other tools. Requires a spanning PAT (hsp_); workspace-scoped tokens are rejected here.","write_action":false,"price_micros":0,"input_schema":null},{"name":"post_activity","description":"Post a structured activity event to an agent session. `kind` is one of thought / tool_use / elicitation / response / error. `content` shape varies by kind: thought/response = { text }, tool_use = { toolName, args, result?, durationMs? }, elicitation = { question }, error = { message, stack? }.","write_action":true,"price_micros":0,"input_schema":null},{"name":"search_issues","description":"Search a workspace by text. Matches issue titles, issue numbers (e.g. \"42\" or \"ENG-42\"), project names, and comment bodies. Comment hits link back to their parent issue.","write_action":false,"price_micros":0,"input_schema":null},{"name":"update_issue","description":"Update an issue \\u2014 pass only the fields to change. null clears assigneeId / storyPoints / dueDate / sprintId ([] clears labelIds); description cannot be cleared, omit to keep it.","write_action":true,"price_micros":0,"input_schema":null},{"name":"update_session","description":"Update your own agent work session \\u2014 move it through its lifecycle (QUEUED \\u2192 WORKING \\u2192 WAITING_INPUT \\u2192 COMPLETED/ERRORED) and report modelUsage, tokenUsage, modelUsed, or externalUrls. Report your usage on the COMPLETED/ERRORED call: nothing else records it, and a session that never reports is shown on the story as unreported, not as zero cost. Requires an agent bearer token (h","write_action":true,"price_micros":0,"input_schema":null}],"scan":{"score":55,"grade":"C","scanned_at":"2026-09-22T17:05:47.348Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-22T17:05:47.244Z","components":{"code":{"score":25,"max":25,"notes":["3 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":3,"max":15,"notes":["repository not readable: repo not found"]},"identity":{"score":2,"max":10,"notes":["no repository or website to verify"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"@hiveship/mcp-server","version":"0.7.0","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":2,"publishedAt":"2026-08-17T12:41:17.528Z","repositoryUrl":"git+https://github.com/SorcRR/HiveShip.git","weeklyDownloads":8}],"repo":{"found":false,"owner":"SorcRR","repo":"HiveShip","error":"repo not found"},"icon":{"url":"https://hiveship.app/favicon.svg","source":"site"},"presence":{"stars":null,"forks":null,"downloadsWeek":8,"license":"MIT","lastPushAt":null,"score":8}}}},"grade_history":[],"reviews":[]}