# mcp

Links your AI assistant to the Matih data platform over MCP. Enables governed SQL execution, table profiling, and semantic metrics inside development tools.

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

## What it does

The server acts as a bridge between AI clients and the Matih data workspace, either over HTTP or via a local stdio process running `npx -y @matihlabs/mcp`. It exposes 34 stable tools alongside the experimental `get_hot_context` tool. The model can inspect schemas, run SQL queries, and manage dashboard charts. Metrics can also be drafted through a proposal pipeline before human review.

Access remains strictly bounded by token permissions. Running the bridge locally requires Node 20 or newer, relying solely on built-in modules without external packages. Without signed tenant egress consent, API calls will fail immediately with an `EGRESS_CONSENT_REQUIRED` error code.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.matih.ai/api/v1/mcp`
- Environment variables: `MATIH_MCP_TOKEN` — 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 mcp https://mcp.matih.ai/api/v1/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env MATIH_MCP_TOKEN=<MATIH_MCP_TOKEN> --transport stdio matih-labs-mcp -- npx -y @matihlabs/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add matih-labs-mcp --url https://mcp.matih.ai/api/v1/mcp
```

2. **Platform CLI**
```bash
codex mcp add matih-labs-mcp --env MATIH_MCP_TOKEN=<MATIH_MCP_TOKEN> -- npx -y @matihlabs/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "matih-labs-mcp": {
            "url": "https://mcp.matih.ai/api/v1/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "matih-labs-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@matihlabs/mcp"
            ],
            "env": {
                "MATIH_MCP_TOKEN": "<MATIH_MCP_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "matih-labs-mcp": {
            "type": "http",
            "url": "https://mcp.matih.ai/api/v1/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "matih-labs-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@matihlabs/mcp"
            ],
            "env": {
                "MATIH_MCP_TOKEN": "<MATIH_MCP_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http matih-labs-mcp https://mcp.matih.ai/api/v1/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e MATIH_MCP_TOKEN=<MATIH_MCP_TOKEN> matih-labs-mcp npx -y @matihlabs/mcp
```
Replace <…> with your own values

## When to use it
- execute SQL queries against connected databases
- profile database tables and inspect column types
- draft semantic metrics for human approval
- generate dashboards and visualize query output

## Example prompts
- List all tables available in the analytics warehouse
- Execute a query on the orders table and profile the status column
- Draft a new revenue metric definition based on billing data

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27844
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49863

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12110
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2766
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1349
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

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