# HypAware

> HypAware is a freemium MCP server for developer tools. Query your team's AI coding-agent session history and apply fix recommendations. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API, macOS, Linux, Windows, vscode
- **Website:** https://hypaware.ai
- **Repository:** https://github.com/hyparam/hypaware-plugin
- **MCP Registry name:** ai.hypaware/hypaware
- **Categories:** developer tools, analytics and data
- **Listing updated:** 2026-11-14

## About

HypAware's premise is that agent transcripts hold the evidence for what goes wrong overnight, and nobody reads them. A local daemon records sessions from tools such as Claude Code, Codex, Cursor, VS Code Copilot, OpenCode and LangGraph apps, stores them as open table files linked into a graph of sessions, files, tools and skills, and analyses them for findings with linked evidence and a root-cause fix.

This MCP server gives an agent access to that history. It connects to the hosted endpoint at api.hypaware.ai/v1/mcp with an agent token in the Authorization header, or runs from the hypaware npm package over stdio. The plugin README says the token acts as the person who minted it: it can read the organization's history, mark a recommendation's status, and publish or delete reports, but cannot change configuration, upload sessions or mint tokens. Tokens last 21 days by default.

The collector and query engine are free and open source and need Node.js 22.12 or newer. HypAware Cloud adds storage, reports and team analysis in Free, Team and Enterprise tiers priced by captured tokens.

## Features

- **Session history queries:** Agents query recorded sessions with grep, SQL and graph lookups.
- **Evidence-linked findings:** Each finding links to the sessions behind it, with a suggested root-cause fix.
- **Recommendation status:** An agent can mark a recommendation as acted on.
- **Fix verification:** Later passes re-check whether earlier findings still occur.
- **Scoped agent tokens:** Query-scoped tokens expire and can be revoked from the CLI.
- **Local or cloud storage:** Keep logs on your machine or sync to HypAware Cloud.

## Good for

- Ask why an overnight agent run took many retries
- Apply a recommended skill or environment fix from an agent
- Find repeated failures across a team's sessions
- Check that a past fix still holds

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hypaware https://api.hypaware.ai/v1/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.hypaware.ai/v1/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hypaware": {
      "url": "https://api.hypaware.ai/v1/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hypaware": {
      "type": "http",
      "url": "https://api.hypaware.ai/v1/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hypaware": {
      "serverUrl": "https://api.hypaware.ai/v1/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hypaware": {
      "type": "http",
      "url": "https://api.hypaware.ai/v1/mcp"
    }
  }
}
```

## FAQ

### How do I connect Claude Code?

Run /plugin marketplace add hyparam/hypaware-plugin, then /plugin install hypaware@hypaware, with HYPAWARE_AGENT_TOKEN set.

### How do I get a token?

Install the CLI, run hyp remote login --no-forward, then hyp remote mint --scope query.

### Is it free?

The local collector and query engine are free and open source. The Free cloud tier covers up to 100M captured tokens a month.

### Where does my data live?

Your choice: local only, or local plus encrypted HypAware Cloud storage.

### Is HypAware free?

HypAware has a free plan, with paid plans for more usage or features.

### How do I add HypAware to Claude Code?

Run this command in your terminal: claude mcp add --transport http hypaware https://api.hypaware.ai/v1/mcp

### What are the best alternatives to HypAware?

The closest alternatives to HypAware 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.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [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.

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