Set up push notifications for Cursor, Claude Code, Windsurf, or any MCP-compatible AI agent in under 5 minutes

What you'll set up

By the end of this guide, your AI agent will be able to:

Send push notifications to your phone when a task finishes
Ask you yes/no questions via push notification — you answer from your lock screen
Alert you when something fails or needs your attention

The entire setup takes about 2 minutes.

Prerequisites

An AI coding tool that supports MCP (Cursor, Claude Code, Windsurf, Lovable, or any MCP client)
A phone or desktop browser for receiving notifications

Create your Pushary account

During onboarding, you'll choose a handle (your personal notification channel) and get your API key. Copy the API key immediately — it's only shown once.

The key looks like this: pk_abc123.sk_xyz789

Connect your AI agent

Choose your tool below and add the Pushary MCP server.

Option A: One-click install

During onboarding, click the "Add to Cursor" button. This opens Cursor and adds Pushary automatically with your API key.

Option B: Manual config

Open Cursor Settings → MCP → Add Server, or add this to your mcp.json:

{
  "pushary": {
    "url": "https://pushary.com/api/mcp/mcp",
    "headers": {
      "Authorization": "Bearer pk_abc123.sk_xyz789"
    }
  }
}

Replace pk_abc123.sk_xyz789 with your actual API key.

Run this command in your terminal:

claude mcp add pushary --transport http https://pushary.com/api/mcp/mcp --header "Authorization:Bearer pk_abc123.sk_xyz789"

Replace pk_abc123.sk_xyz789 with your actual API key.

Add this to your MCP configuration file (the location varies by tool):

{
  "pushary": {
    "url": "https://pushary.com/api/mcp/mcp",
    "headers": {
      "Authorization": "Bearer pk_abc123.sk_xyz789"
    }
  }
}

Replace pk_abc123.sk_xyz789 with your actual API key.

For stdio-only clients (tools that don't support HTTP MCP transport), use the mcp-remote bridge:

{
  "pushary": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://pushary.com/api/mcp/mcp",
      "--header",
      "Authorization:Bearer pk_abc123.sk_xyz789"
    ]
  }
}

Install the Pushary agent skill using the skills CLI. This works with Cursor, Claude Code, Codex, Windsurf, and 38 more agents:

npx skills add pushary/pushary-skill

The skill teaches your agent when and how to send notifications and ask yes/no questions. You still need to add the MCP server config separately (see the other tabs).

Your agent can send notifications, but you need to subscribe to receive them. This is how notifications reach your phone.

Open your Pushary dashboard on your phone's browser (or scan the QR code shown during onboarding)
Your browser will ask for notification permission — tap Allow
On iPhone: you may need to Add to Home Screen first (Share → Add to Home Screen), then open the app and enable notifications
On Android: permission works immediately in Chrome, Edge, or Firefox

→ Detailed phone setup guide

Send your first notification

Ask your agent to send a test:

Send me a test notification via Pushary saying "hello from Cursor"

Your phone should buzz within 2 seconds.

Now try human-in-the-loop — ask your agent something that requires a decision:

Before you refactor this file, ask me via Pushary push notification if I want to keep backward compatibility

Your phone will show the question with Yes/No buttons. Tap your answer and the agent continues.

→ Human-in-the-loop guide

What your agent can do

Once connected, your agent has access to these tools:

Tool	What it does
`send_notification`	Send a push notification (task done, error alert, status update)
`ask_user_yes_no`	Ask a yes/no question and wait for your answer
`wait_for_answer`	Poll for your response to a question
`cancel_question`	Cancel a pending question that's no longer relevant

Plus 15 more tools for managing subscribers, campaigns, templates, and automation flows.

→ Full tools reference

Troubleshooting

Agent says "Not authenticated" or tool calls fail:

Check that your API key is correct and includes both parts (pk_xxx.sk_xxx)
Make sure the Authorization header is formatted as Bearer pk_xxx.sk_xxx

Notifications not arriving on your phone:

Make sure you subscribed to notifications (Step 3 above)
On iPhone, check that you added the page to your Home Screen and enabled notifications
Try sending a test notification from your agent dashboard

Agent doesn't see Pushary tools:

Restart your AI coding tool after adding the MCP config
In Cursor, check Settings → MCP and verify Pushary shows as connected

→ Full troubleshooting guide

Next steps

Receiving notifications — detailed setup for iPhone, Android, and desktop
Human-in-the-loop — yes/no questions with retry logic and best practices
All MCP tools — full reference for all 19 tools
Use cases & prompts — copy-paste prompts for common workflows

What you'll set up

By the end of this guide, your AI agent will be able to:

Send push notifications to your phone when a task finishes
Ask you yes/no questions via push notification — you answer from your lock screen
Alert you when something fails or needs your attention

The entire setup takes about 2 minutes.

Prerequisites

An AI coding tool that supports MCP (Cursor, Claude Code, Windsurf, Lovable, or any MCP client)
A phone or desktop browser for receiving notifications

Create your Pushary account

During onboarding, you'll choose a handle (your personal notification channel) and get your API key. Copy the API key immediately — it's only shown once.

The key looks like this: pk_abc123.sk_xyz789

Connect your AI agent

Choose your tool below and add the Pushary MCP server.

Option A: One-click install

During onboarding, click the "Add to Cursor" button. This opens Cursor and adds Pushary automatically with your API key.

Option B: Manual config

Open Cursor Settings → MCP → Add Server, or add this to your mcp.json:

{
  "pushary": {
    "url": "https://pushary.com/api/mcp/mcp",
    "headers": {
      "Authorization": "Bearer pk_abc123.sk_xyz789"
    }
  }
}

Replace pk_abc123.sk_xyz789 with your actual API key.

Run this command in your terminal:

claude mcp add pushary --transport http https://pushary.com/api/mcp/mcp --header "Authorization:Bearer pk_abc123.sk_xyz789"

Replace pk_abc123.sk_xyz789 with your actual API key.

Add this to your MCP configuration file (the location varies by tool):

{
  "pushary": {
    "url": "https://pushary.com/api/mcp/mcp",
    "headers": {
      "Authorization": "Bearer pk_abc123.sk_xyz789"
    }
  }
}

Replace pk_abc123.sk_xyz789 with your actual API key.

For stdio-only clients (tools that don't support HTTP MCP transport), use the mcp-remote bridge:

{
  "pushary": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://pushary.com/api/mcp/mcp",
      "--header",
      "Authorization:Bearer pk_abc123.sk_xyz789"
    ]
  }
}

Install the Pushary agent skill using the skills CLI. This works with Cursor, Claude Code, Codex, Windsurf, and 38 more agents:

npx skills add pushary/pushary-skill

The skill teaches your agent when and how to send notifications and ask yes/no questions. You still need to add the MCP server config separately (see the other tabs).

Your agent can send notifications, but you need to subscribe to receive them. This is how notifications reach your phone.

Open your Pushary dashboard on your phone's browser (or scan the QR code shown during onboarding)
Your browser will ask for notification permission — tap Allow
On iPhone: you may need to Add to Home Screen first (Share → Add to Home Screen), then open the app and enable notifications
On Android: permission works immediately in Chrome, Edge, or Firefox

→ Detailed phone setup guide

Send your first notification

Ask your agent to send a test:

Send me a test notification via Pushary saying "hello from Cursor"

Your phone should buzz within 2 seconds.

Now try human-in-the-loop — ask your agent something that requires a decision:

Before you refactor this file, ask me via Pushary push notification if I want to keep backward compatibility

Your phone will show the question with Yes/No buttons. Tap your answer and the agent continues.

→ Human-in-the-loop guide

What your agent can do

Once connected, your agent has access to these tools:

Tool	What it does
`send_notification`	Send a push notification (task done, error alert, status update)
`ask_user_yes_no`	Ask a yes/no question and wait for your answer
`wait_for_answer`	Poll for your response to a question
`cancel_question`	Cancel a pending question that's no longer relevant

Plus 15 more tools for managing subscribers, campaigns, templates, and automation flows.

→ Full tools reference

Troubleshooting

Agent says "Not authenticated" or tool calls fail:

Check that your API key is correct and includes both parts (pk_xxx.sk_xxx)
Make sure the Authorization header is formatted as Bearer pk_xxx.sk_xxx

Notifications not arriving on your phone:

Make sure you subscribed to notifications (Step 3 above)
On iPhone, check that you added the page to your Home Screen and enabled notifications
Try sending a test notification from your agent dashboard

Agent doesn't see Pushary tools:

Restart your AI coding tool after adding the MCP config
In Cursor, check Settings → MCP and verify Pushary shows as connected

→ Full troubleshooting guide

Next steps

Receiving notifications — detailed setup for iPhone, Android, and desktop
Human-in-the-loop — yes/no questions with retry logic and best practices
All MCP tools — full reference for all 19 tools
Use cases & prompts — copy-paste prompts for common workflows

Getting Started: Agent Notifications

What you'll set up

Prerequisites

Create your Pushary account

Connect your AI agent

Send your first notification

What your agent can do

Troubleshooting

Next steps

On this page

Getting Started: Agent Notifications

What you'll set up

Prerequisites

Create your Pushary account

Connect your AI agent

Send your first notification

What your agent can do

Troubleshooting

Next steps

On this page