# Oxynote

> Oxynote is an open-source MCP server for developer tools. Self-hosted team docs with live Prometheus and Loki charts, reviewed like pull requests. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, Web, API
- **Repository:** https://github.com/oxynote/oxynote
- **MCP Registry name:** io.github.oxynote/oxynote
- **Categories:** developer tools, knowledge and memory
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

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