Skip to content
WebsitePlatform

Quickstart

Connect an agent to Hookspot and ask why a delivery failed.

Hookspot’s MCP server lets an AI agent, such as Claude Code or ChatGPT, read and change your Hookspot projects as you. Connect one and ask it why your last delivery failed.

In Claude Code, add Hookspot’s MCP server:

claude mcp add --scope user --transport http hookspot https://app.hookspot.dev/mcp

Then run /mcp in claude, select hookspot and choose Authenticate. For another agent, see Connect an agent.

In the browser Claude Code opens:

  1. Tick Read-only, as the agent only needs to read.
  2. Click Approve.

Authorized apps explains the page.

Ask the agent about a destination, the path in your app that receives webhooks:

Why did the last delivery to /webhooks fail in my Hookspot project?

The agent finds the project and the destination, then lists its failed deliveries. It reads the newest one with get_delivery, which holds your app’s response. It then tells you what your app answered, such as a 500 and the error in the response body.

Fix your app, then send the delivery again with Retry a delivery in the dashboard.

A Read-only agent cannot retry for you. To let it, change its access. Tools lists what an agent can read and change.