moo-tasks: Instructions file for Codex

AGENTS.md

Drop this file into the root of any project that uses a Moo Tasks board as its task queue. It tells AI coding agents how to discover, accept, and complete work for this repository through the board's MCP server.

---

1. What is the Moo Tasks board?

Moo Tasks is a kanban board (available at mootasks.dev) that exposes each board as its own Model Context Protocol (MCP) server. The endpoint is scoped to a single board — an agent connected to one board can never see or modify tasks on any other board.

Each task on the board has two identifiers:

• ID: A unique, permanent string ID (e.g., `A86rlBBUBe3f`) used in tool calls.

• Board Task ID: A sequential numeric ID specific to the board (e.g., `1`, `2`). Use this for easier reference in conversation.

• Endpoint URL: https://mootasks.dev/api/boards/<boardId>/mcp (or your self-hosted host)

• Global Endpoint: https://mootasks.dev/api/mcp (requires account token)

• Transport: streamable-http

• Authorization Flow: All requests must include the Authorization header. Use the format: Authorization: Bearer <your-bearer-token> (per MCP basic spec)

⚠️ Tokens via ?token= query string are not supported. Always use the Authorization header.

---

2. Connecting your agent

On the board page, click Show MCP Config → 📋 Copy JSON. Paste the snippet into your MCP client's config:

{
  "mcpServers": {
    "moo-tasks": {
      "type": "streamable-http",
      "url": "https://mootasks.dev/api/boards/<boardId>/mcp",
      "headers": {
        "Authorization": "Bearer <your-bearer-token>"
      }
    }
  }
}

Common locations:

Client	Path
Claude Code	~/.claude.json or project .mcp.json
Cursor	.cursor/mcp.json
VS Code	.vscode/mcp.json
JetBrains	Settings → Tools → MCP Servers
Junie	Settings → MCP Servers