# Vitrus analytics MCP server

> Allows an AI client to perform read-only analytics on web and mobile app traffic, users, retention, and revenue with verifiable SQL evidence.

- Repository: https://github.com/Vitrus-Dev/vitrus
- Page: https://hostedmcp.org/servers/vitrus-dev/vitrus
- Transport: remote
- Stars: 6
- License: Apache-2.0
- Latest version: 0.11.1

## Install

### Claude Code

```sh
claude mcp add --transport http vitrus https://app.vitrus.dev/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "vitrus": {
      "url": "https://app.vitrus.dev/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "vitrus": {
      "type": "http",
      "url": "https://app.vitrus.dev/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"vitrus","type":"http","url":"https://app.vitrus.dev/mcp"}'
```

### Codex

```sh
codex mcp add vitrus --url https://app.vitrus.dev/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.vitrus]
url = "https://app.vitrus.dev/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http vitrus https://app.vitrus.dev/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "vitrus": {
      "url": "https://app.vitrus.dev/mcp",
      "type": "http"
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `VITRUS_PASSWORD` | no | no |  |

## FAQ

### What can I ask the AI about my analytics?

You can ask questions like 'Which of my apps lost the most users this week?' and the AI will answer using counts and the underlying SQL queries.

### How does Vitrus handle user privacy?

User IDs are hashed on the device before being sent, and personal fields like email or phone numbers are removed both in the browser and on the server.

### Can the AI make false claims about my data?

No, Vitrus drops any AI-generated sentence containing a number that is not supported by the underlying SQL evidence.
