# TOPY.AI · AI CSO

TOPY.AI · AI CSO is an MCP server for Claude Code that scans dependencies for CVEs and EOL, detects leaked secrets, and audits third-party MCP servers in a project.

- 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-CSO-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-cso

## What it does

This server gives coding agents a set of security workflows: matching components against fresh CVE databases, tracking end-of-life dates, spotting secrets before commit, and mapping threat models using STRIDE and OWASP ASVS. It also includes incident timelines and remediation roadmaps structured across T1–T4 risk tiers.

Strict guardrails prevent unexpected system changes: the agent never modifies firewalls, remote hosts, or production configurations directly. Active scans run exclusively against verified domains, while host-level auditing requires explicit manual approval granted directly in a terminal.

Without `TOPY_API_KEY` configured in your environment or active account authentication, local stdio calls will not execute.

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

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

### Codex

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

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

### Cursor

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

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

## When to use it
- scan dependencies for active CVEs and end-of-life packages
- audit third-party MCP servers and skills before installation
- catch uncommitted credentials and unsafe code patterns
- generate incident timelines and prioritized fix plans

## Example prompts
- Check our dependencies for new CVEs and end-of-life notices
- Audit this external MCP server before I install it
- Scan the staged code for exposed API keys and secrets

## Similar
- [cso](https://affpapa.org/en/nevibecode/skills/cso.md) — skill · 461 installs
- [patch-tuesday](https://affpapa.org/en/nevibecode/mcp/patch-tuesday.md) — MCP server · ★ 5 repo stars
- [absolute-audit](https://affpapa.org/en/nevibecode/skills/absolute-audit.md) — skill · 592 installs
- [EchelonGraph CVE & Exposure](https://affpapa.org/en/nevibecode/mcp/echelongraph-cve-exposure.md) — MCP server · ★ 25 repo stars
- [remediation](https://affpapa.org/en/nevibecode/skills/remediation.md) — skill · ★ 3785 repo stars
- [exploits](https://affpapa.org/en/nevibecode/skills/exploits.md) — skill · ★ 3785 repo stars

---
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
