Remote MCP setup

Connect your agent to iPhone updates.

Add the remote MCP server so your agent can send task progress or a scheduled check result to Agent Alerts. Sign in through your browser, or use an iPhone-approved connection token on a headless server. Connecting alone does not start monitoring.

Account setup · Step 1

Create your account in the app

Open Agent Alerts on your iPhone, finish onboarding, then create an account with your email and password. Allow notifications and Live Activities when prompted.

Account setup · Step 2

Add the remote MCP server

Use this same endpoint in whichever AI client you use.

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

ChatGPT

Add a custom remote MCP server from Plugins or Connectors, paste the URL below, then choose Connect.

Open ChatGPT setup help

Codex

Paste the MCP URL into Codex to connect. Codex may request phone-number access; the consent page shows it before you approve. The commands below request only the access Agent Alerts uses.

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

Open Codex setup help

Claude Code

Run the command below in your terminal. In Claude Code, open /mcp and sign in to Agent Alerts.

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

Open Claude Code setup help

Claude app

In Settings → Connectors, add a custom connector with the URL below, then authenticate.

Open Claude app setup help

Cursor

Add a custom HTTP MCP server from Cursor’s MCP settings, paste the URL below, then authenticate.

Open Cursor setup help

Account setup · Step 3

Sign in and approve access

Your browser opens the Agent Alerts sign-in page. Use the same email and password as the iPhone app, review the requested access, then approve it. Enter credentials only on the Andreas Ink sign-in page—never in an AI chat.

Headless server

Connect with a connection token

If your MCP client can send a custom HTTP Authorization header, it can use an iPhone-approved connection token without browser sign-in.

Create a connection token on this website and approve it in the Agent Alerts iPhone app. Choose publish-only access for updates, or Full access if this server must poll responses or send requested alarms.
Save the one-time token as AGENTALERTS_AGENT_TOKEN in the server’s secret manager. Enter it outside the AI chat.
Configure the remote MCP URL above and send the token on every MCP request as a Bearer header.

Authorization: Bearer <connection token from secret manager>Create a connection token

Verify the connection

Ask your agent to check Agent Alerts status and send one non-sensitive test update. A successful server response confirms routing; seeing it on your iPhone confirms delivery.

Setting this up with an agent?

Give the agent the setup instructions URL. It should ask when to update, what should interrupt you, and whether a tap should reopen the task or a report in your preferred editor. Keep your token out of chat.

Open agent instructions