ank for MCP apps

No terminal in your AI app? ank works there too. One line for Claude Code:

claude mcp add ank -- ank mcp --repo /path/to/your/repo

Same tool, two ways in

ank.ank/TASK-820dADR-06d2Claude Desktoptools/call ank_claimClaude Code, Codex$ shstdio · JSON-RPCank mcp --repoank claim 820d
Fig. 06ank mcp · ank <verb> → .ank/

Set it up

The same entry for every app. Only the file changes.

.mcp.json · the entry
{
  "mcpServers": {
    "ank": {
      "command": "ank",
      "args": ["mcp", "--repo", "/path/to/your/repo"]
    }
  }
}

Where to put it

Claude Code
.mcp.json at the root of the repo, or the claude mcp add line above.
Claude Desktop
claude_desktop_config.json, in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.
Cursor
.cursor/mcp.json in the repo, or ~/.cursor/mcp.json for all projects.

Every command is a tool

Same commands, same answers as in the terminal.

  • ank_context
  • ank_claim
  • ank_show
  • ank_log
  • ank_done
  • ank_release
  • ank_new
  • ank_review
  • ank_accept
  • ank_read
  • ank_close
  • ank_amend
  • ank_attest
  • ank_find
  • ank_status
  • ank_graph
  • ank_scope
  • ank_tui
  • ank_mcp
  • ank_watch
  • ank_edit
  • ank_check
  • ank_migrate
  • ank_archive
  • ank_config
  • ank_init
  • ank_skills
  • ank_update
  • ank_help
  • Named ank_<command>

    So they don’t clash with other servers’ tools.

  • Same answers

    A tool returns what the command would print, errors included.

  • Same rules

    A task taken through MCP is taken for everyone.

Terminal or MCP?

Your agent has a terminal

Use the command line. Add the skills with npx skills add haksolot/ank.

Your app has no terminal

Use ank mcp. The same commands, as tools.

Install ank

Two commands. Linux, macOS, Windows. Needs git.

npm install -g @haksolot/ank
npx skills add haksolot/ank