Uptimizr
Query your self-hosted 3D scene analytics, with 76 metric tools and gated note-taking
- 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/mcpAdd 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.RequiredUPTIMIZR_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

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted 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

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media