Skip to content
MCP server

Uptimizr

Query your self-hosted 3D scene analytics, with 76 metric tools and gated note-taking

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
self-hosted, CLI
Runs
Locally
Version
1.2.3
Listing updated
3 days ago

About Uptimizr

Uptimizr is an open-source MCP server for analytics and data. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • UPTIMIZR_COLLECTOR_URLBase URL of your own Uptimizr collector.Required
  • UPTIMIZR_API_KEYYour project API key. The query capability reads; add annotate to enable metadata tools.Required

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Open-source package; requires your own collector

Prices change. Check uptimizr.com before you buy.

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

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  6. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media