# Verlon AI MCP

This MCP server lets coding agents inspect Verlon AI gates, logs, recommendations, experiments, and models. Its default tools are read-only.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: verlon-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/verlon-ai/mcp
- Updated: 2026-09-13
- HTML: https://affpapa.org/en/nevibecode/mcp/verlon-ai-mcp

## What it does

The server exposes six tools for viewing gate settings, request logs, Cortex recommendations, experiments, and available models with pricing and capability scores. A separate tool, `switch_model`, can change the model used by a gate, but it is registered only when the server starts with `--enable-writes`.

The MCP client starts the server through `npx`. You need a `VERLON_API_KEY`; `VERLON_BASE_URL` is available when connecting to a self-hosted Verlon instance. Writes are off by default, so the agent cannot switch models unless you opt in with the flag. That matters if you expect to change gate settings through chat.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `VERLON_API_KEY`, `VERLON_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env VERLON_API_KEY=<VERLON_API_KEY> --env VERLON_BASE_URL=<VERLON_BASE_URL> --transport stdio verlon-ai-mcp -- npx -y @verlon-ai/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add verlon-ai-mcp --env VERLON_API_KEY=<VERLON_API_KEY> --env VERLON_BASE_URL=<VERLON_BASE_URL> -- npx -y @verlon-ai/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "verlon-ai-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@verlon-ai/mcp"
            ],
            "env": {
                "VERLON_API_KEY": "<VERLON_API_KEY>",
                "VERLON_BASE_URL": "<VERLON_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "verlon-ai-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@verlon-ai/mcp"
            ],
            "env": {
                "VERLON_API_KEY": "<VERLON_API_KEY>",
                "VERLON_BASE_URL": "<VERLON_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e VERLON_API_KEY=<VERLON_API_KEY> -e VERLON_BASE_URL=<VERLON_BASE_URL> verlon-ai-mcp npx -y @verlon-ai/mcp
```
Replace <…> with your own values

## When to use it
- inspect Verlon AI gate settings
- find failed requests in the logs
- retrieve Cortex recommendations for a gate
- check experiment status and variants
- compare available models and their pricing

## Example prompts
- List my Verlon AI gates and show their settings.
- Find recent failed requests in the Verlon logs.
- Compare the models available to my Verlon AI gates.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

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