# Remote MCP

Connect ChatGPT, Codex, Claude, or Cursor to send Agent Alerts through account sign-in.

Connect an AI client to Agent Alerts through account sign-in. Your client can then send updates to the iPhone signed in with that account.

## Before connecting

Install [Agent Alerts](https://apps.apple.com/us/app/agent-alerts/id6760969938), finish onboarding, and sign in on your iPhone. Make sure your AI client supports remote HTTP MCP connections and browser authentication.

## Add the server

Use this endpoint for sending alerts:

```text
https://www.andreas.ink/api/agent/mcp
```

For a guided connection flow, open [MCP setup](/agent/mcp).

### Codex

```bash
codex mcp add agent-alerts --url https://www.andreas.ink/api/agent/mcp
codex mcp login agent-alerts --scopes openid,email,profile,offline_access
```

### Claude Code

```bash
claude mcp add --transport http --scope user agentalerts https://www.andreas.ink/api/agent/mcp
```

Then open Claude Code, run `/mcp`, and follow the browser sign-in flow.

### ChatGPT, Claude, and Cursor

Add a custom remote HTTP MCP connection in the client's connector or MCP settings. Paste the endpoint above, then follow its browser authentication flow. Client names and settings can differ by version; [MCP setup](/agent/mcp) links to each client's official instructions.

## Sign in and test

Use the same account as your iPhone and review the access request before approving it. Ask the client to check Agent Alerts status, then send a non-sensitive test update.

For example:

```text
Check my Agent Alerts connection. Send one test update saying that setup is ready, then tell me the returned delivery status. I will confirm it on my iPhone.
```

An accepted request is not proof that the Live Activity or notification appeared. Confirm the result on the phone before relying on the connection.

## Agree on the workflow

Tell your agent what to check, which sources it may use, when to refresh, and what needs a notification. Reuse a stable activity key for the same subject. The AI client owns checks and recurring schedules; Agent Alerts receives the updates.

Alarms require an explicit user request. A pending or expired response is not permission to take an action. See [responses and permissions](/agent-alerts/docs/responses-and-permissions).

## Need an unattended connection?

For a service that cannot complete browser authentication, use an iPhone-approved publishing token with the [webhook API](/agent-alerts/docs/webhook-api) or [Swift CLI](/agent-alerts/docs/swift-cli). Keep the token in the runtime's secret storage.

The [public docs MCP](/agent-alerts/docs#read-with-an-agent) is a separate, read-only knowledge connection. It does not sign you in or send alerts.


Source: https://www.andreas.ink/agent-alerts/docs/remote-mcp
