# TOPY.AI · AI COO

TOPY.AI · AI COO is an MCP server for Claude Code and seven other agents: it tracks routine schedules, failures, and approval queues. Failures surface within a day; approvals wait no longer.

- 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-COO-Skills
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/topyai-ai-coo

## What it does

The server connects through `https://topy.ai/mcp/coo` with OAuth against a TOPY.AI account — the same one used for the AI CEO and AI CFO. It runs on Claude Code, Codex, Cursor, GitHub Copilot, Windsurf, Cline, Zed and Gemini CLI.

Fifteen skills are grouped across five plugins, plus a `topy-ai-coo-all` bundle. The scheduler ticks every 5 minutes. After a failure, a retry fires only for read-only operations where nothing was written outside the system — this prevents the same action from running twice. Permission and token errors skip the retry and go straight to a person.

Skills never approve a step on behalf of the founder and never store credentials. Approval links are regenerated when a request has sat for more than a day. The weekly operations report goes to the founder and the CEO.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://topy.ai/mcp/coo`
- 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 coo https://topy.ai/mcp/coo
```

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

### Codex

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

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

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "topyai-ai-coo": {
            "url": "https://topy.ai/mcp/coo"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "topyai-ai-coo": {
            "command": "npx",
            "args": [
                "-y",
                "@topy-ai/coo-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-coo": {
            "type": "http",
            "url": "https://topy.ai/mcp/coo"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "topyai-ai-coo": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@topy-ai/coo-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-coo https://topy.ai/mcp/coo
```

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

## When to use it
- check which routines failed overnight
- run a routine immediately outside its schedule
- see which approvals are waiting on the founder
- generate and send the weekly operations report
- schedule a new routine at a specific time without overlapping others

## Example prompts
- What failed last night?
- What is currently waiting on my approval?
- Send the weekly operations report

## Similar
- [Impri](https://affpapa.org/en/nevibecode/mcp/impri.md) — MCP server · ★ 6 repo stars
- [agentmart](https://affpapa.org/en/nevibecode/plugins/agentmart.md) — plugin · ★ 1596 repo stars
- [agent-manager-skill](https://affpapa.org/en/nevibecode/plugins/agent-manager-skill.md) — plugin · ★ 1013 repo stars
- [Routine Run: write a routine](https://affpapa.org/en/nevibecode/mcp/routine-run-write-a-routine.md) — MCP server · ★ 2 repo stars
- [coo-advisor](https://affpapa.org/en/nevibecode/skills/coo-advisor.md) — skill · 631 installs
- [agentcron](https://affpapa.org/en/nevibecode/mcp/agentcron.md) — MCP server · 545 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
