MCP Server
Coding agents can now interact with hypothesis.sh through the Model Context Protocol. Connect Claude, Cursor, or any MCP-compatible client to send push notifications to your iOS device and test webhook integrations.
Connect your agent
claude mcp add hypothesis --transport sse https://hypothesis.sh/api/mcp/sseNo authentication required. The endpoint is public and works with any MCP client.
Three tools
send_push_notification — Send a push to a pre-registered iOS device. Provide the device ID (from the app's Settings screen), title, and body. Useful for build notifications, deployment alerts, or any CI/CD event.
create_webhook_session — Create a new webhook session and get a unique URL. The URL accepts GET, POST, PUT, PATCH, and DELETE requests with CORS fully open.
list_webhook_events — Retrieve recent events received by a session. Each event includes the HTTP method, headers, and body (parsed JSON or raw text).
Two prompt templates
webhook-testing — Step-by-step workflow for testing webhook integrations. Covers creating sessions, sending test requests with curl, verifying delivery, and handling session expiry.
cicd-notification-setup — Guide for configuring CI/CD systems (GitHub Actions, Vercel, Xcode Cloud) to send mobile notifications. Includes webhook URL setup and native endpoint integration.
Session lifecycle
Webhook sessions expire after 5 minutes of inactivity. When a session expires (HTTP 410), agents can create a new one and continue testing. The prompt templates include guidance on handling expiry gracefully.
Documentation
Full documentation is available at /docs/mcp, including configuration examples for Claude Desktop and Cursor, tool parameters, prompt templates, and troubleshooting.
