# TOPY.AI · AI CTO

TOPY.AI · AI CTO is an MCP server for Claude Code with 17 skills: it breaks down CI failures, reviews PR risk, drafts release notes, and handles safe deploys and rollbacks.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: TOPY-AI-LTD
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/TOPY-AI-LTD/TOPY-AI-CTO-Skills
- Updated: 2026-10-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/topyai-ai-cto

## What it does

The server adds an operational skill set to your agent. It follows CI runs, reads failing logs to say what broke, marks flaky tests, drafts release notes, and judges whether a version is clear to ship. Pull request review, issue triage, dependency alerts and secret-leak checks sit in the same set. Skills come in six plugins, and `topy-ai-cto-all` bundles the whole lot.

The hosted endpoint is `https://topy.ai/mcp/cto`, with OAuth sign-in through a TOPY.AI account. A local stdio build exists as well: `npx @topy-ai/cto-mcp login`, then `npx -y @topy-ai/cto-mcp`. The installer `npx @topy-ai/cto-skills install` writes skills into the agents you already have, and `--category ci,releases` keeps only the sections you pick.

Repo access comes from the TOPY AI GitHub App, added by the account owner; the agent never handles a GitHub token. Merges to the default branch, releases, new repositories and production workflows stay with the owner and get approved on OneMan. With no app on the org, expect an empty repository view.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://topy.ai/mcp/cto`
- Environment variables: `TOPY_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http cto https://topy.ai/mcp/cto
```

2. **Platform CLI**
```bash
claude mcp add --env TOPY_API_KEY=<TOPY_API_KEY> --transport stdio topyai-ai-cto -- npx -y @topy-ai/cto-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add topyai-ai-cto --url https://topy.ai/mcp/cto
```

2. **Platform CLI**
```bash
codex mcp add topyai-ai-cto --env TOPY_API_KEY=<TOPY_API_KEY> -- npx -y @topy-ai/cto-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "topyai-ai-cto": {
            "url": "https://topy.ai/mcp/cto"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "topyai-ai-cto": {
            "command": "npx",
            "args": [
                "-y",
                "@topy-ai/cto-mcp"
            ],
            "env": {
                "TOPY_API_KEY": "<TOPY_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "topyai-ai-cto": {
            "type": "http",
            "url": "https://topy.ai/mcp/cto"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "topyai-ai-cto": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@topy-ai/cto-mcp"
            ],
            "env": {
                "TOPY_API_KEY": "<TOPY_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http topyai-ai-cto https://topy.ai/mcp/cto
```

2. **Platform CLI**
```bash
gemini mcp add -e TOPY_API_KEY=<TOPY_API_KEY> topyai-ai-cto npx -y @topy-ai/cto-mcp
```
Replace <…> with your own values

## When to use it
- explain a failed CI run from its log lines
- quarantine flaky tests
- score a pull request for release risk
- draft release notes and clear the release gate
- triage dependency and secret-scanning alerts

## Example prompts
- Which jobs broke in the last CI run, and why?
- Check PR 42 for risk before merge.
- Is this build safe to ship? Run the release gate and write the notes.

## Similar
- [cto-toolkit](https://affpapa.org/en/nevibecode/plugins/cto-toolkit.md) — plugin · ★ 8 repo stars
- [jackin-release-check](https://affpapa.org/en/nevibecode/skills/jackin-release-check.md) — skill · 469 installs
- [re0-release](https://affpapa.org/en/nevibecode/skills/re0-release.md) — skill · 1400 installs
- [release](https://affpapa.org/en/nevibecode/skills/shpigford-release.md) — skill · 106 installs
- [release-loop](https://affpapa.org/en/nevibecode/commands/release-loop.md) — command · ★ 110 repo stars
- [github-actions](https://affpapa.org/en/nevibecode/skills/bobmatnyc-github-actions.md) — skill · 778 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
