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.