# TractorScope

Hosted MCP server for TractorScope: your agent reads dashboards, runs SQL against connected databases and builds charts.

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

## What it does

TractorScope is a SQL dashboard builder, and this server hands its features to an AI client. The agent can list databases, inspect schemas, browse dashboards and folders, then create or edit charts, filters and alerts and pull chart data. Everything happens inside your own account.

There is nothing to install. The endpoint is `https://api.tractorscope.com/mcp`, it speaks streamable HTTP and signs in with OAuth 2.1 using PKCE and dynamic client registration. During consent you pick read-only or read-and-write access. Connections are listed and can be revoked under MCP Server in the app settings. Database credentials never travel over the connection.

Each tool carries annotations: whether it reads, whether it writes, and whether a write can delete something. Clients use that to auto-approve reads and ask before the rest. `query_database` accepts SELECT statements only and stops at 1,000 rows, so wide selections need aggregation in the query itself.

## Requirements
- Remote server: `https://api.tractorscope.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://api.tractorscope.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add tractorscope --url https://api.tractorscope.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tractorscope": {
            "url": "https://api.tractorscope.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tractorscope": {
            "type": "http",
            "url": "https://api.tractorscope.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http tractorscope https://api.tractorscope.com/mcp
```

## When to use it
- find dashboards that mention revenue
- run a SQL query against a connected database from chat
- turn weekly order counts into a line chart
- recolour series on an existing chart
- set an alert when failed payments spike

## Example prompts
- Which dashboards mention revenue? Open the quarterly one and walk me through each chart.
- Query the orders database for weekly counts over the last twelve weeks and add a line chart to the Sales dashboard.

## Similar
- [data-visualizer](https://affpapa.org/en/nevibecode/skills/data-visualizer.md) — skill · 572 installs
- [data-viz](https://affpapa.org/en/nevibecode/skills/data-viz.md) — skill · 568 installs
- [mcp-dashboards](https://affpapa.org/en/nevibecode/mcp/mcp-dashboards.md) — MCP server · ★ 52
- [data-visualization](https://affpapa.org/en/nevibecode/skills/data-visualization.md) — skill · 26 installs
- [data-analytics-skills-claude](https://affpapa.org/en/nevibecode/skills/data-analytics-skills-claude.md) — skill · 1300 installs
- [build-web-data-visualization](https://affpapa.org/en/nevibecode/plugins/build-web-data-visualization.md) — plugin · ★ 7604

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