TOPY.AI AI COO — MCP server for Claude Code and Codex
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.
MIT updated 2026-10-28
claude mcp add --transport http coo https://topy.ai/mcp/cooWhat TOPY.AI · AI COO 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.
What it helps with
- 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 for the agent
- What failed last night?
- What is currently waiting on my approval?
- Send the weekly operations report
How to install TOPY.AI · AI COO
1Platform CLI: remote server
claude mcp add --transport http coo https://topy.ai/mcp/coo2Platform CLI
claude mcp add --env TOPY_API_KEY=<TOPY_API_KEY> --transport stdio topyai-ai-coo -- npx -y @topy-ai/coo-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add topyai-ai-coo --url https://topy.ai/mcp/coo2Platform CLI
codex mcp add topyai-ai-coo --env TOPY_API_KEY=<TOPY_API_KEY> -- npx -y @topy-ai/coo-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"topyai-ai-coo": {
"url": "https://topy.ai/mcp/coo"
}
}
}{
"mcpServers": {
"topyai-ai-coo": {
"command": "npx",
"args": [
"-y",
"@topy-ai/coo-mcp"
],
"env": {
"TOPY_API_KEY": "<TOPY_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"topyai-ai-coo": {
"type": "http",
"url": "https://topy.ai/mcp/coo"
}
}
}{
"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
1Platform CLI: remote server
gemini mcp add -t http topyai-ai-coo https://topy.ai/mcp/coo2Platform CLI
gemini mcp add -e TOPY_API_KEY=<TOPY_API_KEY> topyai-ai-coo npx -y @topy-ai/coo-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about TOPY.AI · AI COO
How do I install TOPY.AI AI COO in Claude Code?
Run claude mcp add --transport http coo https://topy.ai/mcp/coo. For a local stdio server with an API key, use claude mcp add --env TOPY_API_KEY=<TOPY_API_KEY> --transport stdio topyai-ai-coo -- npx -y @topy-ai/coo-mcp.
What does TOPY.AI AI COO do?
It tracks four standing goals against the scheduler's records: routines run on time, no failed run goes unnoticed within a day, approvals keep moving, and the founder spends less time per outcome.
Does TOPY.AI AI COO require a separate TOPY.AI account?
Yes, the connection uses OAuth with a TOPY.AI account. Only the account that owns the OneMan operation can see its routines and run history.