Oxynote
Self-hosted team docs with live Prometheus and Loki charts, reviewed like pull requests
- Pricing
- Open source
- Platforms
- self-hosted, Web, API
- Runs
- Remotely
- Version
- 0.9.0
- Listing updated
- 1 day ago
About Oxynote
Oxynote is an open-source MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.
Oxynote starts from a complaint the authors describe at length: the wiki says how a service works, Grafana or Datadog shows its metrics, and the fix commands sit in a terminal history. Their answer is a self-hosted workspace where a page holds the explanation, live metric charts and logs together, and any change goes through a draft, a diff and an approval, much like a pull request. The authors previously wrote the ttlcache library.
A Live Metrics block draws a time series, bar chart or gauge from PromQL or SQL queries, and Grafana macros such as $__rate_interval work. A Live Logs block queries a log source such as Loki and colours each level. Pages can query Prometheus, Loki, PostgreSQL, Supabase, MySQL or MariaDB, and SQL sources need a read-only database user so a page cannot alter data. Uptime monitors, AI evals, a database viewer and admin actions are described as in development.
The MCP endpoint is served from your own instance at /core/api/mcp, letting an agent read, write and query the docs. It runs as one Docker container; the README notes a default admin login that you must change before others can reach it.
What it does
- Live metric charts
- Draws charts from PromQL or SQL queries inside a page.
- Live logs
- Shows the newest logs with level colours and a volume strip.
- Draft and review flow
- Changes to text and charts go through a diff and approval.
- Multiple data sources
- Queries Prometheus, Loki, PostgreSQL, Supabase, MySQL and MariaDB.
- Read-only SQL
- Requires read-only database users so pages cannot change data.
- Single container
- Starts with one docker run command and a data volume.
Good for
- Keep on-call runbooks next to the charts they explain
- Review a change to a dashboard and its description together
- Let an agent query team docs and live metrics over MCP
- Migrate Grafana queries into documentation pages
Pricing
Open source
Self-hosted; open source on GitHub
Oxynote FAQ
How do I run it?
With one Docker container: docker run -p 8080:8080 with a data volume and the ghcr.io/oxynote/oxynote image.
Which data sources can pages query?
Prometheus, Loki, PostgreSQL, Supabase, MySQL and MariaDB.
Can a page change my database?
No. SQL sources need a read-only database user.
What should I do after first start?
Change the default admin password, which the login page displays until you do.
Is Oxynote free?
Yes. Oxynote is open source, so you can use and self-host it for free.
What are the best alternatives to Oxynote?
The closest alternatives to Oxynote are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Oxynote

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools