# Uptimizr

> Uptimizr is an open-source MCP server for analytics and data. Query your self-hosted 3D scene analytics, with 76 metric tools and gated note-taking. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI
- **Website:** https://www.uptimizr.com/docs/guides/mcp/
- **Repository:** https://github.com/raananw/uptimizr/tree/HEAD/oss/packages/mcp
- **MCP Registry name:** io.github.RaananW/uptimizr
- **Categories:** analytics and data
- **Listing updated:** 2026-11-14

## About

Uptimizr analyses how people interact with 3D scenes, and this package lets an agent ask questions such as which mesh was clicked most this week. It talks only to your own collector's HTTP query API with GET requests, never to the database directly, so nothing goes to a third party and an agent sees only its own project's aggregated data.

The README says the tool catalog is generated from a metric registry: 76 tools, one per metric the collector serves, of which a plain query key sees 75. The extra one, session_narrative, needs a query:raw key and a collector with raw session retention. There is no ingestion tool, so events cannot be altered or deleted.

One gated exception exists. If the key also holds the annotate capability, the server registers metadata tools for notes, glossary terms, saved analyses and pinned panels, and each write is logged in an agent audit log. The server checks the key at startup, so a read-only key gives a read-only server. Docs advise minting a dedicated key with a rate limit.

## Features

- **Metric-per-tool catalog:** 76 tools, each tied to one documented collector query endpoint.
- **Read-only by key:** A query-only key yields a server that cannot write anything.
- **Gated metadata tools:** annotate-capable keys unlock notes, glossary terms, saved analyses and pinned panels.
- **Audit log:** Every metadata write is recorded against the key.
- **Per-key rate limit:** Docs suggest a budget so an agent does not use up the dashboard's allowance.
- **Hosted option:** The collector can also host the server over Streamable HTTP.

## Good for

- Ask which mesh got the most clicks this week
- Check scene performance and heatmaps from an agent
- Save an analysis or pin a dashboard panel by chat
- Audit what an agent asked for through its labelled key

## Install

### Claude Code (Terminal)

```sh
claude mcp add uptimizr --env UPTIMIZR_COLLECTOR_URL='<UPTIMIZR_COLLECTOR_URL>' --env UPTIMIZR_API_KEY='<UPTIMIZR_API_KEY>' -- npx -y @uptimizr/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "uptimizr": {
      "command": "npx",
      "args": [
        "-y",
        "@uptimizr/mcp"
      ],
      "env": {
        "UPTIMIZR_COLLECTOR_URL": "<UPTIMIZR_COLLECTOR_URL>",
        "UPTIMIZR_API_KEY": "<UPTIMIZR_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "uptimizr": {
      "command": "npx",
      "args": [
        "-y",
        "@uptimizr/mcp"
      ],
      "env": {
        "UPTIMIZR_COLLECTOR_URL": "<UPTIMIZR_COLLECTOR_URL>",
        "UPTIMIZR_API_KEY": "<UPTIMIZR_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "uptimizr": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@uptimizr/mcp"
      ],
      "env": {
        "UPTIMIZR_COLLECTOR_URL": "<UPTIMIZR_COLLECTOR_URL>",
        "UPTIMIZR_API_KEY": "<UPTIMIZR_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "uptimizr": {
      "command": "npx",
      "args": [
        "-y",
        "@uptimizr/mcp"
      ],
      "env": {
        "UPTIMIZR_COLLECTOR_URL": "<UPTIMIZR_COLLECTOR_URL>",
        "UPTIMIZR_API_KEY": "<UPTIMIZR_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "uptimizr": {
      "command": "npx",
      "args": [
        "-y",
        "@uptimizr/mcp"
      ],
      "env": {
        "UPTIMIZR_COLLECTOR_URL": "<UPTIMIZR_COLLECTOR_URL>",
        "UPTIMIZR_API_KEY": "<UPTIMIZR_API_KEY>"
      }
    }
  }
}
```

## Tools

- `session_narrative`: Compacted account of one session; needs a query:raw key.
- `annotate`: Leaves a note in the project metadata.
- `define_term`: Saves a glossary definition.
- `save_analysis`: Saves an analysis.
- `pin_panel`: Pins a panel.
- `unpin_panel`: Unpins a panel.
- `list_annotations`: Lists notes.
- `list_glossary`: Lists glossary terms.
- `list_analyses`: Lists saved analyses.
- `list_panels`: Lists pinned panels.

## FAQ

### What do I need to run it?

A collector URL in UPTIMIZR_COLLECTOR_URL and a project API key in UPTIMIZR_API_KEY.

### Can the agent change my events?

No. Events are read-only and there is no ingestion tool.

### Which key should I use?

A dedicated key with only the query capability, not the owner key printed by init.

### Does data leave my infrastructure?

The README says queries go to your own collector and nothing is sent to a third party.

### Is Uptimizr free?

Yes. Uptimizr is open source, so you can use and self-host it for free.

### How do I add Uptimizr to Claude Code?

Run this command in your terminal: claude mcp add uptimizr --env UPTIMIZR_COLLECTOR_URL='<UPTIMIZR_COLLECTOR_URL>' --env UPTIMIZR_API_KEY='<UPTIMIZR_API_KEY>' -- npx -y @uptimizr/mcp

### What are the best alternatives to Uptimizr?

The closest alternatives to Uptimizr are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/uptimizr
