Metadata-Version: 2.4
Name: agentping
Version: 0.1.4
Summary: MCP server that bridges AI coding agents to developers via AgentPing
Author: Saadman Soor
License-Expression: MIT
License-File: LICENSE
Keywords: agent,ai,approval,claude,copilot,cursor,mcp,notification
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: pydantic>=2.4.0
Requires-Dist: websockets>=11.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Description-Content-Type: text/markdown

# AgentPing — MCP Server

Thin MCP server that bridges any MCP-compatible AI coding agent (Copilot, Cursor, Claude Code, Cline, Aider, Windsurf) to you via the AgentPing cloud relay.

## Install

```bash
pip install agentping
```

## Setup

```bash
agentping setup
```

Paste your API key when prompted. Get your key at [app.agentping.dev](https://app.agentping.dev).

## IDE Configuration

Add to your VS Code / Cursor MCP config (`.vscode/mcp.json` or `mcp.json`):

```json
{
  "mcpServers": {
    "agentping": {
      "command": "agentping",
      "env": {
        "AGENTPING_API_KEY": "sk-ap_live_..."
      }
    }
  }
}
```

## MCP Tools

| Tool | Purpose | Blocks? |
|------|---------|---------|
| `bridge_ping` | Test connectivity | No |
| `bridge_send_approval` | Ask dev to approve/reject | No |
| `bridge_ask_question` | Free-form question | No |
| `bridge_wait_response` | Block until reply | Yes |
| `bridge_check_response` | Non-blocking poll | No |
| `bridge_approve_and_wait` | Send + wait combo | Yes |
| `bridge_send_update` | Progress notification | No |
| `bridge_task_complete` | Task finished notification | No |
| `bridge_list_pending` | List unanswered requests | No |

## License

MIT
