Windsurf and other MCP agents

Windsurf and other MCP clients connect to Pushary with one config block: the server URL and your API key. MCP (Model Context Protocol) is the standard way AI apps call outside tools. Your agent then gets Pushary's notification and question tools, so it can tell you when a task finishes and ask you questions you answer on your phone.

{
  "mcpServers": {
    "pushary": {
      "url": "https://pushary.com/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer pk_xxx.xxx"
      }
    }
  }
}

The agent chooses when to ask. Pushary cannot hold an action in these clients until you approve it. For enforced approvals, use an agent with hooks, such as Claude Code or Codex. Supported agents shows which ones Pushary can enforce.

Connect over MCP

Prefer the terminal? npx pushary@latest setup --agents custom signs you in, saves a key, and prints the server URL and header to use.

Clients that only support stdio

Some clients cannot connect to an HTTP MCP server and only start local commands (stdio). For those, use the mcp-remote bridge, which runs locally and forwards to Pushary:

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

Teach your agent when to ask

The tools alone do not tell your agent when to use them. Install the Pushary skill, a short instruction file, so your agent sends notifications and asks questions at the right moments:

npx skills add Pushary/pushary-skill

Tools your agent gets

The main tools are send_notification, ask_user, wait_for_answer and cancel_question. The full list depends on your key. See the tools reference.

A question blocks for up to about 55 seconds per call. While pending, the agent keeps checking with wait_for_answer and the same question id. Ordinary MCP questions without a host deadline, asked with any key except a connector's, stay open until answered or cancelled. This preserves the question; it does not restart a closed agent.

Tools that are not MCP clients

n8n, Zapier, Make and plain scripts can use the REST endpoint instead, at https://pushary.com/api/v1/server. See Connect any agent.

Next steps