Cursor & Windsurf Setup

Cursor and Windsurf connect to Pushary via MCP. They get access to the same notification and question tools as Claude Code, but without permission hooks (neither agent exposes a hook API).

Cursor

One-click install

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

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.

After adding, check Settings > MCP and verify Pushary shows as connected.

Windsurf

Add this to your MCP configuration file:

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

Other MCP clients

Any agent that supports Streamable HTTP MCP transport can connect with the config above.

For stdio-only clients (tools that don't support HTTP 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 skill

For better agent behavior, install the Pushary skill:

npx skills add Pushary/pushary-skill

The skill teaches your agent when to send notifications proactively (after multi-step tasks, on errors) and how to write concise notification copy. Works with Cursor, Windsurf, and 38+ other agents.

Available tools

Once connected, your agent can use:

Full tools reference