What it does
Read-only MCP for AI usage profiles, leaderboards, stats, and docs; no writes or private data.
- Connects Runs in the cloud
- Account or key No key needed
- Category Developer tools
Use together with
Skills that teach the AI this kind of work; they work alongside this one
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Why it ranks here
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 0/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 8/8 | The cloud endpoint answered at the last check |
| Usage score | 20/100 |
Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Install
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install UsageMax public observability. Follow https://mcp.popnx.com/i/symbaiex-usagemax.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 5/5 checks · What you ask goes through the maker’s server (usagemax.com) · ✓ Commands checked Nov 13, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude · about 2 min
No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it
Open Claude’s Connectors page
CustomizeConnectors
Click “Add” → “Custom” → “Web” and fill in these 2 fields
Copy each value into the field with the same name in Claude, then click Continue
Name · NameUsageMax public observabilityRemote MCP server URL · Addresshttps://usagemax.com/mcpClick Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add
Turn it on in a chat
+ConnectorsUsageMax public observability
Try it
Use UsageMax public observability and tell me what you can do for me, then show me one thing✓ If Claude says it is using UsageMax public observability or shows a UsageMax public observability tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with ChatGPT, depending on your plan
Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only
Open ChatGPT’s add-MCP page on the web
Plugins+Add custom MCP server
Fill in the name and address
Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin
Name · NameUsageMax public observabilityConnection · Addresshttps://usagemax.com/mcpPick UsageMax public observability in a chat
Start a new chat and pick UsageMax public observability from your plugins before typing
Try it
Use UsageMax public observability and tell me what you can do for me, then show me one thing✓ If ChatGPT says it is using UsageMax public observability or shows a UsageMax public observability tool in the answer, you are connected
Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Claude Code · about 2 min
No key, nothing to install
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Paste this command and press Enter
claude mcp add --transport http --scope user usagemax https://usagemax.com/mcpType /mcp in Claude Code
You should see UsageMax public observability listed as connected
Try it
Use UsageMax public observability and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using UsageMax public observability or shows a UsageMax public observability tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor · about 2 min
No key, nothing to install
Open the AI chat in Cursor in Agent mode
Try it
Use UsageMax public observability and tell me what you can do for me, then show me one thing✓ If Cursor says it is using UsageMax public observability or shows a UsageMax public observability tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code · about 2 min
No key, nothing to install
Open the AI chat in VS Code in Agent mode
Try it
Use UsageMax public observability and tell me what you can do for me, then show me one thing✓ If VS Code says it is using UsageMax public observability or shows a UsageMax public observability tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
Address for apps that connect over the web
https://usagemax.com/mcpJSON settings are under “For developers” below
For developers: Terminal commands and JSON settings
Over the web
Claude Code
claude mcp add --transport http --scope user usagemax https://usagemax.com/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"usagemax": {
"url": "https://usagemax.com/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"usagemax": {
"type": "http",
"url": "https://usagemax.com/mcp"
}
}
}These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
At a glance
- Downloads per weeki
- Not on npm/PyPI
- Connection
- Runs in the cloud
- Transport
- streamable-http
- Latest versioni
- 1.0.0
- Categoryi
- Developer tools
- Published to registryi
- Sep 17, 2026
- Code last changedi
- Nov 17, 2026
- Last checked
- Nov 14, 2026
- Maker
- SYMBaiEX
- Website
- usagemax.com
- Registry status
- Active
Which apps can use it
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Connect over the internet in
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
Related guides
What it can do
Tool names and descriptions exactly as the server reported them on Nov 14, 2026. The maker wrote them, not us; we show them as plain text.
public_profileRead one opt-in public UsageMax profile and aggregate statistics.
leaderboardRead the public UsageMax leaderboard (maximum 100 rows).
network_statsRead aggregate public UsageMax network statistics and render the optional inline observability view.
ask_siteAsk a bounded natural-language question about UsageMax and receive cited public resources.
Basic checksi
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
- ✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account SYMBaiEX, which owns the repo
- ✓ Pass
Still maintained
Code last changed 2 days ago
- ✓ Pass
Has a licence
Uses MIT
- ✓ Pass
Endpoint responds
Responded in 921 ms (HTTP 200)
- – Not applicable
Sign-in with OAuth
No sign-in needed
- ✓ Pass
No hidden instructions in tool descriptions
Read 4 tool descriptions and found no hidden instructions to the AI
Makers: ask for a re-check or report wrong info
For makers: add a badge to your README
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/symbaiex-usagemax)Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
User reviews
No reviews yet
Compared with others in Developer toolsi
- More stars than 0% of the other 6103 servers in this category
- Published to the registry more recently than 36% of the other 6103 servers in this category
- Basic checks equal to or better than 99% of the other 6103 servers in this category
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
Common questions
Is UsageMax public observability safe?
It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
What keys or codes does it need?
The registry does not list a required key, though some servers ask you to sign in on first use.
Does it run on my computer or in the cloud?
It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.
Is it still maintained?
The GitHub repo last changed 2 days ago, and the latest version (1.0.0) reached the registry 2 months ago.
Which apps can use it?
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).
What can I use instead?
In the same category: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
Similar alternatives
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Cloudflare MCP
Cloudflare MCP servers
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| This one UsageMax public observability | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| Runs where | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Cloud or install on your computer |
| Needs a key | No | No | No | No | No | No |
| Add with + in Claude | No | No | No | Yes | No | No |
| Basic checks | 5/5 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| License | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
README from the maker
Open the README
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
UsageMax
Your AI work, in perspective.
A private-by-default usage ledger for people and teams building with AI.
Live app · Docs · Integrations · Pricing · How we count · Issues
UsageMax reconciles the AI usage histories already on your computers into one clear view of tokens, model mix, tracked cost, sessions, and activity. The open-source CLI performs bounded local scans and uploads aggregate snapshots to the versioned UsageMax API.
The short version: one-shot collector, private by default, public only by
choice. Prompts and completions never leave the computer.
What you get
| Surface | Purpose |
|---|---|
| Private workspace | Compare computers, providers, models, projects, and cost centers in one tenant-scoped view. |
| Public profile | Opt-in profile, leaderboard, activity, model mix, cost estimate, and streaks. |
| Collector API | Installation-bound, write-only snapshots and content-free telemetry. |
| `usagemax` CLI | A bunx-friendly scanner with archive recovery, safe diagnostics, and optional OS scheduling. |
| Agent interfaces | Bounded OpenAPI, MCP, Markdown, WebMCP, A2A, and installable skill surfaces. |
The physical HUD/screen project is intentionally separate from this repository. It can consume UsageMax telemetry, but it is not required to use the platform.
Connect a computer
1. Create a link code
Sign in at usagemax.com/account, choose Link a computer, give it a name, and copy the one-use command. The code is valid for ten minutes and can be used once.
2. Link and sync
Run the command on the computer or WSL distribution that owns the history:
bunx usagemax link UMX-XXXX-XXXX-XXXX-XXXX
Optional explicit name; the account keeps this name for the installation.
bunx usagemax link UMX-XXXX-XXXX-XXXX-XXXX --name "Work laptop"
The first link performs a full one-shot sync. Every installation receives a stable random ID, so relinking or renaming it rotates its key without creating a duplicate device.
3. Reconcile when you choose
bunx usagemax sync --dry-run --explain # inspect the bounded plan
bunx usagemax sync # upload changed usage bunx usagemax sync --full # reconcile all retained history bunx usagemax status --remote # check the saved credential safely
CLI updates and progress
The CLI checks npm's latest dist-tag at most twice per day. Run usagemax update to update a global installation through Bun or npm; use --check for a read-only check. Run usagemax update sync to hand a command to the current release without typing @latest, or set USAGEMAX_AUTO_UPDATE=1 for an explicit automatic handoff. Use --no-update-check or set USAGEMAX_DISABLE_UPDATE_CHECK=1 in offline environments. Interactive terminals show a small stderr progress line; JSON, quiet, CI, and scheduled runs remain machine-readable and quiet.
Coverage and correctness
UsageMax pins ccusage v20.0.24 and uses its 16 adapters: Amp, Claude Code, Codebuff, Codex, GitHub Copilot CLI, Factory Droid, Gemini CLI, Goose, Grok Build, Hermes, Kilo Code, Kimi CLI, OpenClaw, OpenCode, Pi, and Qwen Code. Named Pi-format stores are discovered as well.
The collector recognizes supported provider overrides, bounded home locations, Claude Desktop sessions, .cc-mirror, renamed Claude/Codex backup folders, and supported Windows homes from WSL. Normal syncs inspect known locations and immediate home entries; they do not crawl the whole disk.
bunx usagemax doctor # metadata-only coverage check
bunx usagemax doctor --deep --json # retained-history audit bunx usagemax sync --archives # one-time compressed-history recovery bunx usagemax report # local ccusage report bunx usagemax status --json # version, coverage, checkpoints, and link state bunx usagemax update --json # machine-readable npm release check
Full scans can catalog retained history from 2024 onward. A readable file inventory is not proof that an aggregate parser consumed every file and day. UsageMax reports those two states separately; counter decreases and missing rows remain protected unless the parser explicitly certifies its coverage. Unknown models stay unattributed; unknown pricing stays unknown.
Cursor, Windsurf, Aider, Continue, Cline, Roo Code, hosted agents, direct provider API traffic, and enterprise billing systems do not all expose a stable local ledger. Feed those through the native or OTLP/HTTP JSON contract, or use a provider billing export when local evidence is unavailable.
Privacy and resource use
| Stays on the computer | May be uploaded |
|---|---|
| Prompts and completions | Aggregate token counters |
| Source code and file contents | Provider, model, and source names |
| Project paths and tool payloads | Dates, costs, and coverage state |
| Provider credentials and secrets | Opaque SHA-256 session identities |
The CLI is short-lived. It skips unchanged inventories, parses only the necessary date range, uses a local lock to prevent overlap, and never downloads a package per run. Optional scheduling invokes the same one-shot process and backs off after failures.
bun install -g usagemax
usagemax service install # approximately every 15 minutes usagemax service install --every 30 usagemax service status usagemax service uninstall
Scheduling is opt-in. macOS uses a user LaunchAgent, Linux/WSL uses a user systemd timer, and Windows uses Task Scheduler. Sleeping or battery-powered computers are not needlessly woken.
Credentials and safe diagnostics
UsageMax has separate credentials for website sign-in, one-use linking, and collector writes. A collector key is exactly umx_ followed by 64 lowercase hexadecimal characters. It is generated server-side, displayed once, stored locally with user-only permissions, and stored by UsageMax only as a SHA-256 hash.
For an Advanced · custom telemetry collector key, pipe the secret through stdin. Never put it in a command-line argument, URL, request body, repository, or log:
set +x
set -o pipefail printf '%s' "$USAGEMAX_COLLECTOR_TOKEN" \ | bunx usagemax token status \ --json \ | jq -r '[.httpStatus, (if .ingestAuthorized then 1 else 0 end)] | @tsv'
token status and telemetry test are included in CLI 0.3.11. If a fresh environment still has an older npm tag, run usagemax update token status or use node packages/cli/src/cli.js token status from this repository until the new package is published.
To prove the authenticated write path, send one content-free agent_state event with all token and cost values set to zero:
set +x
set -o pipefail printf '%s' "$USAGEMAX_COLLECTOR_TOKEN" \ | bunx usagemax telemetry test \ --token-stdin \ --json
This writes one observability event and does not change token or spend totals. An unbound advanced key becomes bound to this CLI installation on its first accepted write. The CLI returns a non-zero exit code if the credential cannot ingest or the API rejects the event.
The numeric projection is deliberately small:
| Result | Meaning |
|---|---|
200 1 | Recognized, active, and authorized to ingest. |
200 0 | Recognized but blocked; inspect the redacted JSON status. |
409 0 | The installation UUID does not match the key binding. |
401 0 | The format/key was not accepted; the server does not reveal which reason. |
The read-only diagnostic reports credential type, scopes, activation state, profile/name, binding state, and last accepted/rejected write. It never returns the token, its hash, or the authorized UUID. Advanced keys are active immediately; they bind on the first valid write. Linked CLI keys are bound during the link exchange.
Agent and developer surfaces
| Surface | URL |
|---|---|
| OpenAPI | openapi.json |
| Agent capability view | /?mode=agent |
| Public MCP | server-card.json |
| Documentation MCP | /docs-mcp |
| A2A card | agent-card.json |
| Skills index | agent-skills/index.json |
| MCP Registry metadata | server.json |
| Skill source and install docs | skills/ · skills.sh |
| Auth guide | /auth.md |
Public reads are bounded and unauthenticated. The public MCP servers are stateless, read-only, and do not expose private workspace data or collector credentials. Collector ingestion is a separate authenticated API boundary.
Repository map
src/ Next.js web app, public routes, docs, and UI
convex/ Convex schema, authorization, ingestion, and projections packages/cli/ Distributable usagemax package docs/ Architecture, contracts, coverage, operations, and releases skills/ Direct-installable agent skills and source notes server.json MCP Registry submission metadata for the public remote server
For the documentation map, start with docs/README.md. It separates public product and integration guidance from contributor, operator, release, and historical records.
MCP Registry and skills.sh status
The public MCP server is published in the official Registry as io.github.SYMBaiEX/usagemax@1.0.0. The server.json file is the versioned source metadata for that listing; it contains no package or credential claim. The three `ski