> ## Documentation Index
> Fetch the complete documentation index at: https://hmm.heyhyper.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Hyper MCP — AI Memory Layer for Engineering Teams

> Connect any MCP-compatible AI client to Hyper's shared memory layer. Query team context, save decisions, and automate memory capture with lifecycle hooks.

The Hyper MCP server exposes your team's shared memory directly inside any MCP-compatible AI client — Claude, Cursor, Windsurf, and others. Once connected, your AI assistant can look up decisions your team has made, save new observations to shared memory, and keep everyone's context in sync automatically through lifecycle hooks. You get a persistent, collaborative knowledge layer without any manual bookkeeping.

## Server URL

Point your MCP client at the Hyper server to get started:

```text theme={null}
https://hyperlink.gethyper.space/mcp
```

<Note>
  For local development, use `http://localhost:8000/mcp` instead. Authentication works the same way in both environments.
</Note>

The first time you connect, your client will prompt you to sign in with Google via OAuth 2.0. After that, a token is stored locally and all subsequent connections are seamless. See the [Authentication guide](/mcp/authentication) for details.

## Adding Hyper to Your AI Client

Add the Hyper MCP server through your client's settings. Most clients accept a server URL directly — paste in `https://hyperlink.gethyper.space/mcp` and follow the OAuth prompt to complete setup.

<Tabs>
  <Tab title="Claude Desktop">
    Open **Settings → Integrations → MCP Servers** and add a new server with the URL `https://hyperlink.gethyper.space/mcp`. Claude will walk you through the Google sign-in flow on first connect.
  </Tab>

  <Tab title="Cursor">
    Open **Cursor Settings → Features → MCP** and click **Add MCP Server**. Enter `https://hyperlink.gethyper.space/mcp` as the server URL. Cursor will handle the OAuth handshake automatically.
  </Tab>

  <Tab title="Windsurf">
    Navigate to **Windsurf Settings → AI → MCP Servers**, add a new entry, and paste in `https://hyperlink.gethyper.space/mcp`. Sign in with Google when prompted.
  </Tab>
</Tabs>

## Available Tools

Hyper exposes six tools over MCP. Each tool is purpose-built for a specific interaction with team memory — reading, writing, correcting, or toggling visibility.

| Tool                                              | What it does                                                                          |
| ------------------------------------------------- | ------------------------------------------------------------------------------------- |
| [`connect`](/mcp/tools/connect)                   | Resolves your identity, loads your workspace briefing, and bootstraps every session   |
| [`ask`](/mcp/tools/ask)                           | Queries team memory with a natural-language question and returns a synthesized answer |
| [`remember`](/mcp/tools/remember)                 | Saves a decision, observation, or status change to shared team memory                 |
| [`correct`](/mcp/tools/correct)                   | Records a human correction and propagates it across all affected memory documents     |
| [`ask-with-history`](/mcp/tools/ask-with-history) | Returns both the current state of a topic and its full evolution over time            |
| [`mute`](/mcp/tools/mute)                         | Toggles incognito mode, pausing all memory writes without affecting reads             |

<CardGroup cols={2}>
  <Card title="connect" icon="plug" href="/mcp/tools/connect">
    Start every session by resolving your identity and loading your workspace briefing.
  </Card>

  <Card title="ask" icon="magnifying-glass" href="/mcp/tools/ask">
    Query your team's collective knowledge with a plain-English question.
  </Card>

  <Card title="remember" icon="brain" href="/mcp/tools/remember">
    Persist a decision, observation, or event to shared memory in one sentence.
  </Card>

  <Card title="correct" icon="pen-to-square" href="/mcp/tools/correct">
    Fix wrong information in Hyper and propagate the correction everywhere it appears.
  </Card>

  <Card title="ask with history" icon="clock-rotate-left" href="/mcp/tools/ask-with-history">
    See current state plus the full change history for any topic or decision.
  </Card>

  <Card title="mute" icon="microphone-slash" href="/mcp/tools/mute">
    Pause memory writes for private sessions without losing read access.
  </Card>
</CardGroup>

## Lifecycle Hooks

Hyper's real power comes from lifecycle hooks — automatic tool calls that fire at key moments in a conversation so you never have to think about memory management manually.

| Hook                 | When it fires                              | What it calls                                                                      |
| -------------------- | ------------------------------------------ | ---------------------------------------------------------------------------------- |
| **SessionStart**     | At the beginning of every new conversation | `connect` — loads your identity and workspace briefing                             |
| **UserPromptSubmit** | Each time you send a message               | `ask` with your message — surfaces relevant team context before the model responds |
| **Stop**             | When the conversation ends or is paused    | `remember` or an observation — captures what happened for future sessions          |

<Tip>
  Configure these hooks once in your AI client and Hyper becomes invisible infrastructure — your assistant always has team context without you lifting a finger.
</Tip>

## Next Steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="lock" href="/mcp/authentication">
    Understand how OAuth tokens work, where they're stored, and how to join additional workspaces.
  </Card>

  <Card title="connect" icon="plug" href="/mcp/tools/connect">
    Learn how the connect tool bootstraps every session with your identity and briefing.
  </Card>
</CardGroup>