# HypAware MCP server

> Lets an AI client query your team's AI coding history and act on HypAware recommendations.

- Repository: https://github.com/hyparam/hypaware-plugin
- Page: https://hostedmcp.org/servers/hyparam/hypaware-plugin
- Transport: stdio, remote
- Stars: 0
- License: MIT
- Latest version: 1.43.0

## Install

### Claude Code

```sh
claude mcp add hypaware-plugin -- npx -y hypaware
```

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

```json
{
  "mcpServers": {
    "hypaware-plugin": {
      "command": "npx",
      "args": [
        "-y",
        "hypaware"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "hypaware-plugin": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hypaware"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "hypaware-plugin": {
      "command": "npx",
      "args": [
        "-y",
        "hypaware"
      ]
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.hypaware-plugin]
command = "npx"
args = ["-y", "hypaware"]
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "hypaware-plugin": {
      "command": "npx",
      "args": [
        "-y",
        "hypaware"
      ]
    }
  }
}
```

## FAQ

### How do I get a HypAware agent token?

Install the CLI with npm, sign in for queries only with `hyp remote login --no-forward`, then mint a token with `hyp remote mint --scope query --label <where-it-runs>`. Tokens last 21 days by default and can be extended up to the server limit.

### What can a HypAware agent token do?

It acts as the person who minted it and can read your organization's recorded history, mark recommendation status, publish reports, and delete reports. It cannot change configuration, record or upload sessions, manage the organization, or mint more tokens.

### Does the HypAware plugin record my activity?

No. The plugin only reads and acts; it has no hooks, commands, agents, or binaries and records nothing on your machine. Recording is handled by the `hyp` CLI and `hyp attach`.

### Why does my HypAware MCP server fail to connect with HTTP 401?

An HTTP 401 means the HYPAWARE_AGENT_TOKEN is unset or no longer valid. Start your client from a shell where the token is exported, or mint a new token.