# Relay

Cross-AI memory sync for coding tools. Relay keeps project context — decisions, progress, constraints, and notes - synchronized across ChatGPT, Claude, Cursor, Codex, and other AI assistants. Capture…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add onrelay/relay

# Browse available tools
npx -y @smithery/cli@latest tool list onrelay/relay

# Get full schema for a tool
npx -y @smithery/cli@latest tool get onrelay/relay project.list

# Call a tool
npx -y @smithery/cli@latest tool call onrelay/relay project.list '{}'
```

## Direct MCP Connection

Endpoint: `https://relay--onrelay.run.tools`

**Required config:**
- `token` (header) — Your Relay MCP token. Get one by running: npx @onrelay/wizard

## Tools (9)

- `project.list` — List all Relay projects you have access to. Returns project IDs, names, slugs, and descriptions.
- `project.get_brief` — Fetch a project context brief — decisions, constraints, progress, and memory items formatted for an AI coding session.
- `project.get_state` — Get full structured project state including overview, objectives, decisions, constraints, and tasks.
- `memory.search` — Search memory items by keyword or semantic query. Returns matching decisions, constraints, tasks, notes, and other memo…
- `memory.add` — Add a memory item to the project. Use this to persist decisions, constraints, tasks, or notes discovered during the ses…
- `context.save` — Save a structured session summary with decisions, progress, next steps, and constraints. Call this at the end of a codi…
- `memory.manage` — Update, delete, or archive an existing memory item by its ID.
- `project.update` — Update a project's name or description.
- `memory.recall` — Search memory and retrieve project state in one call. Use before making decisions to check for existing constraints and…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get onrelay/relay <tool-name>
```

## Resources

- `relay://session-guidelines` — Relay session guidelines for AI coding tools

## Prompts (1)

- `relay_session_guidelines` — Guidelines for using Relay tools effectively during a coding session.