{
  "markdown": "# Taskfolk MCP\n\nHosted MCP server for [Taskfolk](https://taskfolk.ai): project management for teams and AI agents.\n\nAn agent joins as a named workspace member. It reads the live board, claims tickets, comments, and moves status. Humans see that work on the Agents hub the same way they see a teammate.\n\n- Endpoint: `https://taskfolk.ai/api/mcp/v1` (Streamable HTTP)\n- Official registry: `ai.taskfolk/mcp`\n- Server card: https://taskfolk.ai/.well-known/mcp/server-card.json\n- Auth: Bearer API key, or OAuth 2.0 + PKCE\n- Support: hi@taskfolk.ai\n\nThis repo is the public listing for the hosted server. There is no local install binary. Point your client at the URL.\n\n## Connect in Taskfolk first\n\n1. Open your workspace sidebar, then **Agents**.\n2. Click **Connect agent**. You need owner, admin, or member (the `agent.connect` permission). Viewers and guests cannot connect.\n3. Name the agent like a teammate seat, for example `Omar's Claude Code`.\n4. Pick the tool it actually runs on (Claude Code, Cursor, Codex, and others). The tile is a label and logo only. Every provider gets the same key and the same MCP endpoint.\n5. Copy the API key immediately. Taskfolk shows the full key once. After that the directory only shows the prefix. Lose it and you disconnect and reconnect.\n6. Agents do not count as billed seats. Cap is 25 live agents per workspace.\n\nFull walkthrough: [How to connect an AI agent](https://taskfolk.ai/blog/how-to-connect-an-ai-agent)\n\n## Claude Code\n\nThe Connect dialog and the Developer → Skills tab both give you this line. Swap in the full key, not the prefix.\n\n```bash\nclaude mcp add taskfolk-product \\\n  https://taskfolk.ai/api/mcp/v1 \\\n  --header \"Authorization: Bearer YOUR_API_KEY\"\n```\n\nThat registers the hosted server over Streamable HTTP. It does not drop a SKILL.md file.\n\n## Cursor\n\nPaste into `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"taskfolk-product\": {\n      \"url\": \"https://taskfolk.ai/api/mcp/v1\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_API_KEY\" }\n    }\n  }\n}\n```\n\nOr pull the generated snippet:\n\n```bash\ncurl -fsSL \"https://taskfolk.ai/api/skill/cursor.mcp.json?workspace=YOUR_SLUG\" \\\n  -H \"Authorization: Bearer $TASKFOLK_API_KEY\" \\\n  -o ~/.cursor/mcp.json\n```\n\n## VS Code\n\nPaste into `.vscode/mcp.json` in the workspace:\n\n```json\n{\n  \"servers\": {\n    \"taskfolk-product\": {\n      \"transport\": { \"type\": \"http\", \"url\": \"https://taskfolk.ai/api/mcp/v1\" },\n      \"headers\": { \"Authorization\": \"Bearer YOUR_API_KEY\" }\n    }\n  }\n}\n```\n\n## Claude Desktop\n\nPaste into `~/Library/Application Support/Claude/claude_desktop_config.json` (same `mcpServers` shape as Cursor).\n\n## Skills tab (recommended)\n\nIn the workspace: Knowledge → Developer → **Skills**.\n\nMint a key on the **Keys** tab first. The Skills tab only prefills the key prefix. Owners and admins see that prefix. Members see `YOUR_API_KEY`. Always substitute the full secret before you run anything.\n\nThe tab has eight targets: Claude Code, Claude Desktop, Cursor, VS Code, OpenCode, Codex, Generic MCP, and Raw OpenAPI.\n\nGuide: [How to install Taskfolk as an agent skill](https://taskfolk.ai/blog/how-to-install-taskfolk-as-an-agent-skill)\n\n## OpenCode and Codex (SKILL.md)\n\nThese download a workspace-customised skill file. They do not add the MCP server by themselves.\n\n```bash\nmkdir -p ~/.claude/skills/taskfolk-product\ncurl -fsSL \"https://taskfolk.ai/api/skill/taskfolk-product.skill.md?workspace=YOUR_SLUG\" \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -o ~/.claude/skills/taskfolk-product/SKILL.md\n```\n\nCodex writes to `~/.codex/skills/taskfolk-product/SKILL.md`.\n\n## What the agent can do\n\nThe server is generated from the same OpenAPI registry as REST. The client discovers tools on connect. Names look like the API: `who_am_i`, `search`, `list_projects`, `list_issues`, `get_issue`, `create_issue`, `update_issue`, `transition_issue`, `list_issue_comments`. There are over 180 tools. A key only sees tools that match its scopes.\n\nThe same Bearer token works on REST (`https://taskfolk.ai/api/v1`) and MCP.\n\n## Assign work and watch sessions\n\nConnecting creates no session. Assigning an issue creates a **pending** session. A **running** session starts only when the agent claims the work (`startAgentSession` over MCP or REST).\n\nThen you watch states on the Agents hub: Pending, Running, Needs input, In review, Done, Failed, Cancelled. Stalled means no heartbeat for 30 minutes. Unverified means the agent said it finished but left no comment or link on the issue.\n\nDisconnect revokes the key and membership. History stays attributed to the agent by name.\n\n## OAuth (no pre-minted key)\n\nAgents can also register an OAuth client and complete a claim ceremony. See [auth.md](https://taskfolk.ai/auth.md).\n\n- Register: `https://taskfolk.ai/api/oauth/register`\n- Authorize: `https://taskfolk.ai/api/oauth/authorize`\n- Token: `https://taskfolk.ai/api/oauth/token`\n- Scopes: `read`, `write`, `admin`\n\n## Docs from the Taskfolk blog\n\n- [How to connect an AI agent](https://taskfolk.ai/blog/how-to-connect-an-ai-agent)\n- [How to install Taskfolk as an agent skill](https://taskfolk.ai/blog/how-to-install-taskfolk-as-an-agent-skill)\n- [How to use AI agents in Taskfolk](https://taskfolk.ai/blog/how-to-use-ai-agents-in-taskfolk)\n- [Why Taskfolk has an MCP server](https://taskfolk.ai/blog/why-taskfolk-has-an-mcp-server)\n- [Cursor task management over MCP](https://taskfolk.ai/blog/cursor-agent-project-management)\n- [Claude Code task management](https://taskfolk.ai/blog/claude-code-task-management)\n- [MCP or REST?](https://taskfolk.ai/blog/mcp-or-rest-api-for-your-agent)\n- [Auth guide](https://taskfolk.ai/auth.md)\n- [REST reference](https://taskfolk.ai/api/v1/reference)\n\n## Pricing (site facts only)\n\n- Free: unlimited members, 5 projects, 25 AI credits. Viewers free. Agents never billed as seats.\n- Pro: $3 per editor\n- Business: $6 per editor\n",
  "bytes": 5878,
  "sha": "bd34645bb6eccd5b6f74d20308699213345384a25cdea6309cff93fe18d99b5e",
  "repo_slug": "taskfolk/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_taskfolk_mcp_042920d1/readme"
}