AgileHero

AgileHero MCP server

Agile project management your AI agent can operate. AgileHero is a project tool for agile teams — kanban boards, epics and roadmap, retrospectives, estimation poker, whiteboards, a wiki and delivery metrics in one workspace — and every module is exposed to AI assistants over the Model Context Protocol through 49 tools.

This repository is the public connector kit for the hosted server. There is no server code here: the server runs at https://mcp.agilehero.io/mcp, and these files describe it to MCP clients and catalogs (the registry manifest, a Claude Code plugin, client configuration) and document what it can do.

• Website: https://agilehero.io
• Setup guide and supported clients: https://agilehero.io/docs/mcp (also in this repo: docs/setup.md, docs/tools.md, docs/agilehero-markup.md)
• AgileHero Markup (rich-text) specification: https://agilehero.io/docs/mcp/agilehero-markup
• Official MCP Registry entry: io.agilehero/agilehero
• Also published on: Smithery · Glama · LobeHub

Connect

Endpoint	https://mcp.agilehero.io/mcp
Transport	Streamable HTTP
Authentication	OAuth 2.1 — you sign in with your AgileHero account from the client; no API key to paste. The client must support Client ID Metadata Documents (Claude Code, Claude.ai, VS Code, Codex, Zed and others; Cursor and Gemini CLI are not yet supported).
Permissions	The agent acts as you — it can do exactly what your account can do, nothing more.
Plans	Every plan, including Free. Wiki, whiteboard, retrospective and roadmap tools need a workspace on Pro or on the 14-day trial.
Daily limit	Tool calls are metered per user per workspace: 500 a day on Free, 5,000 on Pro or trial, reset at 00:00 UTC.

Claude Code

claude mcp add --transport http agilehero https://mcp.agilehero.io/mcp

Then run /mcp inside Claude Code and follow the sign-in link.

Claude Code plugin — this repository is also a plugin marketplace with one plugin; install it and the server comes with it.

claude plugin marketplace add agilehero-io/agilehero-mcp
claude plugin install agilehero@agilehero

Any other MCP client — point it at the endpoint above; the client discovers the authorization server on its own (RFC 9728 protected-resource metadata) and opens the sign-in. Per-client steps for VS Code, Codex, Zed and more: https://agilehero.io/docs/mcp.

Generic configuration (.mcp.json):

{ "mcpServers": { "agilehero": { "type": "http", "url": "https://mcp.agilehero.io/mcp" } } }

What an agent can do

Ask it to triage a backlog, break a spec into an epic with cards, estimate, move work across the board, write up a retrospective, turn a whiteboard brainstorm into cards, or draft a wiki page — in your own workspace, with your permissions, with every change appearing live for your team.

Conventions the server tells every client at initialize time: every id is a short uid returned by a list/get/search tool (never invented); most tools need a project uid (call list_projects first); rich text is AgileHero Markup (AHM), a strict XML dialect — call get_ahm_spec once before writing any; description and wiki edits are two-step by design (preview, then apply with the returned token).

Tools (49)

Discovery & search

Tool	What it does
list_projects	List every workspace and project the token's user can access, so the agent can resolve the project uid that…
search	The product's global full-text search (OpenSearch): cards, epics, wiki pages and projects, matching titles,…
search_cards	Title-substring card search within one project (kanban board and backlog), matching the product's in-project…
list_project_users	List the members of a project so the agent can resolve assignee uids
list_board_lists	List the lists of a project's kanban board so the agent can resolve a valid move_card destination.
list_labels	List a project's labels so the agent can reuse the existing taxonomy instead of creating near-duplicates on…

Cards & epics

Tool	What it does
list_cards	List the cards of one kanban list, or of the project's backlog when list_id is omitted or empty, in board…
get_card	Retrieve detailed information about a card by its ID
create_card	Create a new card on a project's kanban board, with any combination of supported fields
update_card	Update an existing card by its uid.
move_card	Move a card to a different list (or change its position within the same list).
delete_card	Soft-delete a card by its uid
list_epics	List a project's epics so the agent can resolve epic uids for get_epic and card assignment.
get_epic	Retrieve detailed information about an epic by its ID
create_epic	Create a new epic on a project, with any combination of supported fields
update_epic	Update an existing epic by its uid; only supplied fields are changed.
delete_epic	Soft-delete an epic by its uid.
create_label	Create a new label on a project by name.
create_comment	Add a comment to a card or to an epic.
delete_comment	Delete a comment YOU posted (comments are attributed to the signed-in user this client acts as — other…

Rich text (AgileHero Markup)

Tool	What it does
get_ahm_spec	The AgileHero Markup (AHM) v1.0 specification — the ONLY rich-text format AgileHero accepts (markdown and…
preview_description_update	REQUIRED first step of every card or epic description edit: validates the block operations and returns the…
update_description	Apply a previously previewed description update to a card or epic.

Wiki

Tool	What it does
list_wiki_paths	List all wiki paths (pages and folders) for a project
show_wiki_page	Retrieve a wiki page as AgileHero Markup (AHM) with its document_version.
create_wiki_page	Create a wiki page (optionally inside a folder) with AgileHero Markup (AHM) content.
preview_wiki_page_update	REQUIRED first step of every wiki page update: validates the operations and returns the server-computed…
update_wiki_page	Apply a previously previewed update to a wiki page.

Whiteboards

Tool	What it does
list_whiteboards	List the whiteboards of a project (uid, name, element count, url).
create_whiteboard	Create an empty whiteboard on a project.
get_whiteboard	Read a whiteboard as a compact text representation: board bounds plus one line per element — " at…
create_whiteboard_elements	Create up to 100 whiteboard elements in one transactional call (all-or-nothing, one realtime event).
create_whiteboard_diagram	Draw a diagram (flowchart, process, dependency graph) on a whiteboard from a semantic graph — nodes, edges,…
update_whiteboard_elements	Update up to 100 whiteboard elements in one all-or-nothing call: move (x/y), resize, restack (z_index),…
delete_whiteboard_elements	Delete up to 100 whiteboard elements in one transactional call.
review_whiteboard	Run deterministic quality checks on a whiteboard: text likely overflowing its element, visibly overlapping…
convert_whiteboard_element	Convert a whiteboard element into a backlog item: a sticky note into a card or an epic, or a frame into an…
convert_mind_map	Convert a mind map into backlog items with a per-node mapping: the root can become a new epic (role "epic")…

Retrospectives

Tool	What it does
list_retrospectives	List a project's retrospective meetings, most recent first (uid, name, date, url).
create_retrospective	Create a retrospective meeting.
get_retrospective	Read a retrospective meeting: its columns (with uids — the handles add_retro_items and move_retro_item take),…
add_retro_items	Add items to a retrospective board, several at once.
move_retro_item	Move a retrospective item to another column of its retro board.

Roadmap

Tool	What it does
list_roadmap_slots	List a project's roadmap slots overlapping a date window (default: this month through five months out).
create_roadmap_slot	Schedule an epic on the project roadmap: a slot from start_date to end_date, optionally with assignees.
update_roadmap_slot	Update a roadmap slot: reschedule or resize (start_date/end_date), move it to another epic of the same…
delete_roadmap_slot	PERMANENTLY delete a roadmap slot (and its assignee links).

Metrics & attention

Tool	What it does
list_attention_cards	List the cards needing attention on a project's kanban board — the same lists as the product's Metrics pages.
get_metrics_summary	One-call counts of the cards needing attention on a project's kanban board: overdue_cards_count,…

Files in this repository

File	Purpose
docs/setup.md	Per-client connection instructions, generated
docs/tools.md	All 49 tools with parameters and a call example each, generated
docs/agilehero-markup.md	The AHM rich-text specification, generated
data/mcp-docs.json	Source of the three generated docs (bin/rails mcp:docs in the backend)
scripts/generate-docs.mjs	Regenerates docs/ from that JSON
context7.json	Parsing and agent-rule configuration for documentation indexes
server.json	Manifest published to the Official MCP Registry
.mcp.json	Client configuration for the hosted server
.claude-plugin/plugin.json	Claude Code plugin manifest (validated with claude plugin validate)
.claude-plugin/marketplace.json	Marketplace manifest so the plugin installs straight from this repository
assets/agilehero-icon-512.png	Icon for catalogs

Pricing

2 seats free forever. Pro is $12/month plus $9 per extra seat, with a 14-day trial of every premium module and no credit card. Details: https://agilehero.io/pricing.

Support

https://agilehero.io/contact/ · [email protected]

License

The files in this repository are released under the MIT License. AgileHero itself is a hosted, proprietary service; its Terms apply to the account you sign in with.