Skip to content

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, 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:

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

For a guided connection flow, open MCP setup.

Codex

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

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 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:

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.

Need an unattended connection?

For a service that cannot complete browser authentication, use an iPhone-approved publishing token with the webhook API or Swift CLI. Keep the token in the runtime's secret storage.

The public docs MCP is a separate, read-only knowledge connection. It does not sign you in or send alerts.