agent-toolkit-cli 1.11.0__py3-none-win_amd64.whl

agent_toolkit/data/mcp/registry/clickup.yaml

@@ -0,0 +1,48 @@
+# MCP Provider: clickup
+# Research: docs/wiki/MCP-Setup.md · mcp/templates/clickup/
+id: clickup
+display_name: ClickUp
+purpose: View and create tasks, manage lists and spaces, add comments, read and write Docs
+implementation:
+  provenance: community
+  package: mcp-clickup-server
+  repository: https://github.com/nazruden/clickup-mcp-server
+  license: MIT
+  version_policy: pin to minor
+transport:
+  supported: [stdio]
+  preferred: stdio
+auth:
+  supported: [bearer-env]
+  preferred: bearer-env
+  env: [CLICKUP_API_TOKEN]
+tools:
+  read:
+    - get_task
+    - get_list
+    - get_space
+    - get_doc
+  write:
+    - create_task
+    - update_task
+    - create_comment
+  destructive:
+    - delete_task
+approval:
+  default: read-only
+healthcheck:
+  strategy: tools-list
+  timeout_ms: 5000
+platforms:
+  claude-code: native
+  cursor: native
+  opencode: bridged
+  copilot-cli: unknown-blocked
+  gemini-cli: bridged
+  windsurf: manual
+  pi: bridged
+  codex: unknown-blocked
+security:
+  network_hosts: [api.clickup.com, app.clickup.com]
+  secret_storage: environment variable
+  notes: Prefer clickup-cli skill for day-to-day task ops; MCP for agent tool use

agent_toolkit/data/mcp/registry/figma.yaml

@@ -0,0 +1,44 @@
+# MCP Provider: figma
+# Research: docs/wiki/MCP-Setup.md · mcp/templates/figma/
+id: figma
+display_name: Figma
+purpose: Fetch design context, file structure, component metadata, and screenshots for design-to-code
+implementation:
+  provenance: official
+  package: "https://mcp.figma.com/mcp"
+  repository: https://www.figma.com/developers/mcp
+  license: proprietary
+  version_policy: remote hosted
+transport:
+  supported: [streamable_http]
+  preferred: streamable_http
+auth:
+  supported: [bearer-env]
+  preferred: bearer-env
+  env: [FIGMA_OAUTH_TOKEN, FIGMA_REGION]
+tools:
+  read:
+    - get_design_context
+    - get_file_structure
+    - get_screenshot
+    - get_metadata
+  write: []
+  destructive: []
+approval:
+  default: read-only
+healthcheck:
+  strategy: tools-list
+  timeout_ms: 8000
+platforms:
+  claude-code: native
+  cursor: native
+  opencode: bridged
+  copilot-cli: unknown-blocked
+  gemini-cli: bridged
+  windsurf: manual
+  pi: bridged
+  codex: unknown-blocked
+security:
+  network_hosts: [mcp.figma.com, api.figma.com]
+  secret_storage: environment variable
+  notes: Prefer file-content read-only PAT; set FIGMA_REGION (us|eu) for regional routing

agent_toolkit/data/mcp/registry/github.yaml

@@ -0,0 +1,52 @@
+# MCP Provider: github
+# Official: https://github.com/github/github-mcp-server
+# Note: @modelcontextprotocol/server-github is deprecated (Apr 2025).
+id: github
+display_name: GitHub
+purpose: Access GitHub repositories, issues, PRs, code, and CI via the official GitHub MCP server
+implementation:
+  provenance: official
+  package: ghcr.io/github/github-mcp-server
+  repository: https://github.com/github/github-mcp-server
+  license: MIT
+  version_policy: pin image digest or minor tag
+transport:
+  supported: [stdio]
+  preferred: stdio
+auth:
+  supported: [bearer-env, oauth]
+  preferred: bearer-env
+  env: [GITHUB_PERSONAL_ACCESS_TOKEN]
+tools:
+  read:
+    - get_file_contents
+    - list_issues
+    - get_issue
+    - list_pull_requests
+    - get_pull_request
+    - search_repositories
+    - search_code
+  write:
+    - create_issue
+    - create_pull_request
+    - create_or_update_file
+  destructive:
+    - delete_file
+approval:
+  default: read-only
+healthcheck:
+  strategy: tools-list
+  timeout_ms: 8000
+platforms:
+  claude-code: native
+  cursor: native
+  opencode: bridged
+  copilot-cli: native
+  gemini-cli: native
+  windsurf: manual
+  pi: bridged
+  codex: bridged
+security:
+  network_hosts: [api.github.com, ghcr.io]
+  secret_storage: environment variable
+  notes: Prefer fine-grained PAT via GITHUB_PERSONAL_ACCESS_TOKEN; OAuth also supported by official server

agent_toolkit/data/mcp/registry/linear.yaml

@@ -0,0 +1,47 @@
+# MCP Provider: linear
+# Research: docs/wiki/MCP-Setup.md · mcp/templates/linear/
+id: linear
+display_name: Linear
+purpose: Create and update issues, manage projects and cycles, add comments, query sprints
+implementation:
+  provenance: official
+  package: "https://mcp.linear.app/mcp"
+  repository: https://linear.app/docs/mcp
+  license: proprietary
+  version_policy: remote hosted
+transport:
+  supported: [streamable_http, sse]
+  preferred: streamable_http
+auth:
+  supported: [oauth]
+  preferred: oauth
+  env: []
+tools:
+  read:
+    - list_issues
+    - get_issue
+    - list_projects
+    - list_cycles
+  write:
+    - create_issue
+    - update_issue
+    - create_comment
+  destructive: []
+approval:
+  default: read-only
+healthcheck:
+  strategy: tools-list
+  timeout_ms: 8000
+platforms:
+  claude-code: native
+  cursor: native
+  opencode: bridged
+  copilot-cli: unknown-blocked
+  gemini-cli: bridged
+  windsurf: manual
+  pi: bridged
+  codex: unknown-blocked
+security:
+  network_hosts: [mcp.linear.app, linear.app]
+  secret_storage: oauth browser flow
+  notes: Official Linear MCP uses OAuth; no API token required for streamable HTTP

agent_toolkit/data/mcp/registry/notion.yaml

@@ -0,0 +1,48 @@
+# MCP Provider: notion
+# Research: docs/wiki/MCP-Setup.md · mcp/templates/notion/
+id: notion
+display_name: Notion
+purpose: Read and write Notion pages and databases, query blocks, and create content
+implementation:
+  provenance: community
+  package: mcp-notion-server
+  repository: https://github.com/suekou/mcp-notion-server
+  license: MIT
+  version_policy: pin to minor
+transport:
+  supported: [stdio]
+  preferred: stdio
+auth:
+  supported: [bearer-env]
+  preferred: bearer-env
+  env: [NOTION_API_TOKEN]
+tools:
+  read:
+    - notion_retrieve_page
+    - notion_retrieve_database
+    - notion_query_database
+    - notion_retrieve_block_children
+  write:
+    - notion_create_page
+    - notion_update_page
+    - notion_append_block_children
+  destructive:
+    - notion_delete_block
+approval:
+  default: read-only
+healthcheck:
+  strategy: tools-list
+  timeout_ms: 5000
+platforms:
+  claude-code: native
+  cursor: native
+  opencode: bridged
+  copilot-cli: unknown-blocked
+  gemini-cli: bridged
+  windsurf: manual
+  pi: bridged
+  codex: unknown-blocked
+security:
+  network_hosts: [api.notion.com]
+  secret_storage: environment variable
+  notes: Integration can only access pages/databases explicitly shared with it

agent_toolkit/data/mcp/registry/slack.yaml

@@ -0,0 +1,46 @@
+# MCP Provider: slack
+# Research: docs/wiki/MCP-Setup.md · mcp/templates/slack/
+id: slack
+display_name: Slack
+purpose: Read channel history, post messages, add reactions, and browse Slack canvases
+implementation:
+  provenance: official
+  package: "@anthropic-ai/mcp-server-slack"
+  repository: https://github.com/anthropics/mcp-servers
+  license: MIT
+  version_policy: pin to minor
+transport:
+  supported: [stdio]
+  preferred: stdio
+auth:
+  supported: [bearer-env]
+  preferred: bearer-env
+  env: [SLACK_BOT_TOKEN, SLACK_APP_TOKEN]
+tools:
+  read:
+    - conversations_history
+    - conversations_list
+    - users_list
+    - canvases_sections_lookup
+  write:
+    - chat_post_message
+    - reactions_add
+  destructive: []
+approval:
+  default: read-only
+healthcheck:
+  strategy: tools-list
+  timeout_ms: 5000
+platforms:
+  claude-code: native
+  cursor: native
+  opencode: bridged
+  copilot-cli: unknown-blocked
+  gemini-cli: bridged
+  windsurf: manual
+  pi: bridged
+  codex: unknown-blocked
+security:
+  network_hosts: [slack.com, api.slack.com]
+  secret_storage: environment variable
+  notes: Requires both bot token (API) and app token (Socket Mode); invite bot to channels

agent_toolkit/data/mcp/templates/chrome-devtools/README.md

@@ -0,0 +1,57 @@
+# Chrome DevTools MCP — Template
+
+Official: [ChromeDevTools/chrome-devtools-mcp](https://github.com/ChromeDevTools/chrome-devtools-mcp) — Apache-2.0 — `npm:chrome-devtools-mcp`.
+
+## Quick start
+
+**Claude Code (plugin + skills, recommended):**
+```bash
+/plugin marketplace add ChromeDevTools/chrome-devtools-mcp
+/plugin install chrome-devtools-mcp@chrome-devtools-plugin
+```
+Restart Claude Code, check `/mcp` or `/skills`.
+
+**Claude Code (MCP-only):**
+```bash
+claude mcp add chrome-devtools -- npx -y chrome-devtools-mcp@latest
+```
+
+**Generic (Cline/Gemini/Codex):**
+```json
+{
+  "mcpServers": {
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest"]
+    }
+  }
+}
+```
+
+### Slim mode (smaller context)
+```json
+{
+  "mcpServers": {
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest", "--slim", "--headless"]
+    }
+  }
+}
+```
+
+## Flags
+
+- `--slim` — reduced tool set
+- `--headless` — headless Chrome
+- `--isolated` — per-session instance
+- `--browser-url=http://127.0.0.1:9222` — attach to existing Chrome
+- `--no-performance-crux` — disable CrUX fetch
+- `--no-usage-statistics` — opt out Google stats (or `CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS=1`, `CI=1` auto)
+- `--no-update-checks` — disable npm update ping (`CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS=1`)
+
+See `skills/tooling/chrome-devtools/SKILL.md` for Playwright vs DevTools decision table and `mcp/registry/chrome-devtools.yaml` for provenance.
+
+## Security
+
+DevTools exposes all browser content to the MCP client — avoid sensitive pages. Usage stats enabled by default — opt out as above. See skill for full boundaries.

agent_toolkit/data/mcp/templates/chrome-devtools/config.template.json

@@ -0,0 +1,6 @@
+{
+  "name": "chrome-devtools",
+  "command": "npx",
+  "args": ["-y", "chrome-devtools-mcp@latest"],
+  "env": {}
+}

agent_toolkit/data/mcp/templates/clickup/README.md

@@ -0,0 +1,45 @@
+# ClickUp MCP Template
+
+> **Deprecated** — The ClickUp MCP server is no longer the recommended integration.
+> Use the [`clickup` CLI](https://triptechtravel.github.io/clickup-cli/) instead.
+> The workstation installs the global skill at `~/.local/share/agent-toolkit/skills/clickup-cli/SKILL.md`.
+
+## Why the CLI is preferred
+
+| | ClickUp MCP | `clickup` CLI |
+|---|---|---|
+| Token cost | High — MCP responses are verbose JSON blobs | Low — structured `--json`/`--jq` output, ~90% less noise with `rtk` |
+| Auth | Requires server process + API token in config | Token stored in system keyring; CI via `--with-token` |
+| Git integration | None | Auto-detects task IDs from branch names |
+| Maintenance | External server process to keep running | Single binary, no daemon |
+
+## Migration
+
+Remove the ClickUp MCP server from your agent config and install the CLI instead:
+
+```bash
+# Install (macOS/Linux with Homebrew)
+brew install triptechtravel/tap/clickup
+
+# Install (go)
+go install github.com/triptechtravel/clickup-cli/cmd/clickup@latest
+
+# Authenticate
+clickup auth login
+
+# Select default space
+clickup space select
+```
+
+The `clickup-cli` skill is deployed by chezmoi at `~/.local/share/agent-toolkit/skills/clickup-cli/` and linked globally for Claude Code, Cursor, Copilot, OpenCode, and pi.
+
+## Legacy reference
+
+The MCP config template and wrapper script are kept below for reference only.
+Do not use them for new setups.
+
+### Required environment variables (legacy)
+
+- `CLICKUP_API_TOKEN`
+
+Use `config.template.json` and `wrapper.sh` as legacy examples only.

agent_toolkit/data/mcp/templates/clickup/config.template.json

@@ -0,0 +1,8 @@
+{
+  "name": "clickup",
+  "command": "npx",
+  "args": ["-y", "mcp-clickup-server"],
+  "env": {
+    "CLICKUP_API_TOKEN": "${CLICKUP_API_TOKEN}"
+  }
+}

agent_toolkit/data/mcp/templates/clickup/wrapper.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -eo pipefail
+
+if [[ -t 1 && -z ${NO_COLOR:-} ]]; then
+  c_reset=$'\033[0m'
+  c_blue=$'\033[1;34m'
+  c_red=$'\033[1;31m'
+else
+  c_reset=''
+  c_blue=''
+  c_red=''
+fi
+
+info() { printf '%b[mcp-wrapper]%b %s\n' "$c_blue" "$c_reset" "$*"; }
+fail() { printf '%b[mcp-wrapper]%b %s\n' "$c_red" "$c_reset" "$*"; }
+
+if [[ -z ${CLICKUP_API_TOKEN:-} ]]; then
+  fail "CLICKUP_API_TOKEN is required" >&2
+  exit 1
+fi
+
+info "starting mcp-clickup-server"
+exec mcp-clickup-server

agent_toolkit/data/mcp/templates/figma/README.md

@@ -0,0 +1,54 @@
+# Figma MCP Template
+
+Connects an AI tool to the remote Figma MCP server
+(`https://mcp.figma.com/mcp`, streamable HTTP with bearer-token auth).
+
+## Required environment variables
+
+- `FIGMA_OAUTH_TOKEN` — personal access token or OAuth token with read +
+  assets scopes.
+- `FIGMA_REGION` — Figma region header (default `us-east-1`).
+
+Store them in a local env file (never commit tokens):
+
+```bash
+mkdir -p ~/.config/agent-toolkit/env.d
+cat >> ~/.config/agent-toolkit/env.d/figma.env <<'EOF'
+export FIGMA_OAUTH_TOKEN="<paste-token-here>"
+export FIGMA_REGION="us-east-1"
+EOF
+chmod 600 ~/.config/agent-toolkit/env.d/figma.env
+# Then: source ~/.config/agent-toolkit/env.d/figma.env
+```
+
+> [!CAUTION]
+> Tokens copied from the Figma UI must not include surrounding quotes. Never
+> commit `figma.env` to a repository.
+
+## How to use
+
+The transport is **streamable HTTP** — there is no local `command`/`wrapper.sh`.
+Each AI tool registers MCP servers in its own configuration file:
+
+| AI tool | Configuration file |
+|---------|--------------------|
+| Claude Code | `~/.claude/mcp.json` (or `claude mcp add figma --transport http --url https://mcp.figma.com/mcp --header "Authorization: Bearer $FIGMA_OAUTH_TOKEN" --header "X-Figma-Region: $FIGMA_REGION"`) |
+| Cursor | `~/.cursor/mcp.json` |
+| OpenCode | `~/.config/opencode/mcp.json` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
+
+Copy the values from `config.template.json` and substitute the env vars at
+registration time. Restart your AI tool so it re-reads the MCP config.
+
+## Verify
+
+1. Run `dots-doctor` and confirm `figma.env` is listed under Integrations.
+2. Restart your AI tool.
+3. Ask the AI to call `whoami` on the Figma MCP — it should return your Figma
+   user identity.
+
+## See also
+
+- `~/.local/share/agent-toolkit/skills/figma/SKILL.md` and the `figma-*` skill
+  family.
+- `docs/MCP_TEMPLATES.md`

agent_toolkit/data/mcp/templates/figma/config.template.json

@@ -0,0 +1,9 @@
+{
+  "name": "figma",
+  "transport": "streamable_http",
+  "url": "https://mcp.figma.com/mcp",
+  "headers": {
+    "Authorization": "Bearer ${FIGMA_OAUTH_TOKEN}",
+    "X-Figma-Region": "${FIGMA_REGION}"
+  }
+}

agent_toolkit/data/mcp/templates/github/README.md

@@ -0,0 +1,16 @@
+# GitHub MCP Template
+
+Official server: [`github/github-mcp-server`](https://github.com/github/github-mcp-server)
+(`ghcr.io/github/github-mcp-server`). The npm package
+`@modelcontextprotocol/server-github` is **deprecated** as of April 2025.
+
+## Required environment variables
+
+- `GITHUB_PERSONAL_ACCESS_TOKEN` — fine-grained or classic PAT
+
+## Usage
+
+1. Ensure Docker is available.
+2. Copy `config.template.json` into your MCP client config.
+3. Export `GITHUB_PERSONAL_ACCESS_TOKEN`.
+4. Optionally run `./wrapper.sh` as a local launcher example.

agent_toolkit/data/mcp/templates/github/config.template.json

@@ -0,0 +1,15 @@
+{
+  "name": "github",
+  "command": "docker",
+  "args": [
+    "run",
+    "-i",
+    "--rm",
+    "-e",
+    "GITHUB_PERSONAL_ACCESS_TOKEN",
+    "ghcr.io/github/github-mcp-server"
+  ],
+  "env": {
+    "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
+  }
+}

agent_toolkit/data/mcp/templates/github/wrapper.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+: "${GITHUB_PERSONAL_ACCESS_TOKEN:?Set GITHUB_PERSONAL_ACCESS_TOKEN}"
+exec docker run -i --rm \
+  -e GITHUB_PERSONAL_ACCESS_TOKEN \
+  ghcr.io/github/github-mcp-server

agent_toolkit/data/mcp/templates/linear/README.md

@@ -0,0 +1,49 @@
+# Linear MCP Template
+
+Connects an AI tool to Linear via the official remote MCP server
+(`https://mcp.linear.app/mcp`, OAuth — no API token needed).
+
+## Required environment variables
+
+- None. Authentication is OAuth, prompted by your AI tool on first call.
+
+## How to use
+
+The transport is **streamable HTTP**, not a local `command`/`wrapper.sh`. Each
+AI tool registers MCP servers slightly differently — pick the relevant
+configuration file and copy the URL from `config.template.json`:
+
+| AI tool | Configuration file |
+|---------|--------------------|
+| Claude Code | `~/.claude/mcp.json` (or `claude mcp add linear --transport http --url https://mcp.linear.app/mcp`) |
+| Cursor | `~/.cursor/mcp.json` |
+| OpenCode | `~/.config/opencode/mcp.json` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
+
+The first Linear tool call triggers an OAuth window in your browser. After login
+the session is cached by the AI tool.
+
+## Windows / WSL fallback
+
+If direct streamable-HTTP connections are blocked on Windows, run the MCP
+through WSL using `mcp-remote`:
+
+```jsonc
+{
+  "mcpServers": {
+    "linear": {
+      "command": "wsl",
+      "args": ["npx", "-y", "mcp-remote", "https://mcp.linear.app/sse", "--transport", "sse-only"]
+    }
+  }
+}
+```
+
+That snippet is also embedded in `config.template.json` under the
+`_comment_windows_wsl_fallback` key for reference.
+
+## See also
+
+- `~/.local/share/agent-toolkit/skills/linear/SKILL.md` — the linear skill that
+  drives this MCP.
+- `docs/MCP_TEMPLATES.md`

agent_toolkit/data/mcp/templates/linear/config.template.json

@@ -0,0 +1,10 @@
+{
+  "name": "linear",
+  "transport": "streamable_http",
+  "url": "https://mcp.linear.app/mcp",
+  "auth": "oauth",
+  "_comment_windows_wsl_fallback": {
+    "command": "wsl",
+    "args": ["npx", "-y", "mcp-remote", "https://mcp.linear.app/sse", "--transport", "sse-only"]
+  }
+}

agent_toolkit/data/mcp/templates/notion/README.md

@@ -0,0 +1,7 @@
+# Notion MCP Template
+
+## Required environment variables
+
+- `NOTION_API_TOKEN`
+
+Use `config.template.json` and `wrapper.sh` as baseline examples.

agent_toolkit/data/mcp/templates/notion/config.template.json

@@ -0,0 +1,8 @@
+{
+  "name": "notion",
+  "command": "npx",
+  "args": ["-y", "mcp-notion-server"],
+  "env": {
+    "NOTION_API_TOKEN": "${NOTION_API_TOKEN}"
+  }
+}

agent_toolkit/data/mcp/templates/notion/wrapper.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -eo pipefail
+
+if [[ -t 1 && -z ${NO_COLOR:-} ]]; then
+  c_reset=$'\033[0m'
+  c_blue=$'\033[1;34m'
+  c_red=$'\033[1;31m'
+else
+  c_reset=''
+  c_blue=''
+  c_red=''
+fi
+
+info() { printf '%b[mcp-wrapper]%b %s\n' "$c_blue" "$c_reset" "$*"; }
+fail() { printf '%b[mcp-wrapper]%b %s\n' "$c_red" "$c_reset" "$*"; }
+
+if [[ -z ${NOTION_API_TOKEN:-} ]]; then
+  fail "NOTION_API_TOKEN is required" >&2
+  exit 1
+fi
+
+info "starting mcp-notion-server"
+exec mcp-notion-server

agent_toolkit/data/mcp/templates/slack/README.md

@@ -0,0 +1,8 @@
+# Slack MCP Template
+
+## Required environment variables
+
+- `SLACK_BOT_TOKEN`
+- `SLACK_APP_TOKEN`
+
+Use `config.template.json` and `wrapper.sh` as baseline examples.

agent_toolkit/data/mcp/templates/slack/config.template.json

@@ -0,0 +1,9 @@
+{
+  "name": "slack",
+  "command": "npx",
+  "args": ["-y", "@anthropic-ai/mcp-server-slack"],
+  "env": {
+    "SLACK_BOT_TOKEN": "${SLACK_BOT_TOKEN}",
+    "SLACK_APP_TOKEN": "${SLACK_APP_TOKEN}"
+  }
+}