# Relaydeck

> Relaydeck shows the work of AI coding agents on iPhone, iPad, and Apple Watch. An agent connects to the MCP server with an API key. It creates tasks, reports status and progress, sends notifications, and asks the person questions.

- MCP endpoint: `https://relaydeck.onrender.com/mcp` (Streamable HTTP, header `Authorization: Bearer <API key>`).
- One-line setup for an agent: `curl -fsSL https://relaydeck.onrender.com/install | sh`.
- The person creates each API key in the app. The account is anonymous: no email and no password.

## Docs

- [Overview](https://relaydeck.onrender.com/docs/overview.md): Relaydeck is one service for AI agents and for the Apple app. An agent reports its work as tasks and asks the person questions.
- [Quickstart](https://relaydeck.onrender.com/docs/quickstart.md): Connect an AI agent to Relaydeck. After that, the tasks of the agent show on your iPhone, iPad, and Apple Watch.
- [MCP](https://relaydeck.onrender.com/docs/mcp.md): POST /mcp is the endpoint for AI agents. It implements the Model Context Protocol, revision 2026-07-28, on the Streamable HTTP transport.
- [REST API](https://relaydeck.onrender.com/docs/rest-api.md): The Apple app and scripts use the routes under /v1. Read Overview first for authentication, errors, and limits.
- [Events](https://relaydeck.onrender.com/docs/events.md): GET /v1/events with an account token returns a stream of server-sent events (text/event-stream). The app uses it to show each change at once.
- [Inbox](https://relaydeck.onrender.com/docs/inbox.md): Each key has an inbox. It holds what the person and other agents send to that key.
- [Push](https://relaydeck.onrender.com/docs/push.md): The server sends pushes through the Apple Push Notification service (APNs) to the devices of an account. A device registers its tokens with PUT /v1/devices/{device_id}.
- [App integrity](https://relaydeck.onrender.com/docs/app-integrity.md): A server can ask for proof that a request comes from the real app. There are two checks. Each check is off until the operator configures it.
- [Self-hosting](https://relaydeck.onrender.com/docs/self-hosting.md): The server is one Python service and one Redis-compatible Key Value store (Valkey). You can run it on your own machine or on a host such as Render.

## Optional

- [Install script](https://relaydeck.onrender.com/install.sh): The shell script that the one-line setup runs.
- [All docs in one file](https://relaydeck.onrender.com/llms-full.txt): Every page above, joined.
- [Privacy](https://relaydeck.onrender.com/privacy): What the server stores and how to delete it.
- [Source code](https://github.com/Aayush9029/mcp-server): The open source server.