docs(mcp): use event-centric terminology instead of webhook-heavy language

Hookdeck is HTTP in, HTTP out — webhook events are one type of event
trigger. Update tool descriptions and README to reflect this:
- "webhook sources" → "inbound sources"
- "webhook delivery destinations" → "delivery destinations"
- "webhook payloads" → "event payloads"
- "webhook connections" → "connections"
- "webhook traffic" → "event traffic"
- Use "webhook events" only where specifically about webhooks

https://claude.ai/code/session_01Y2eJZgKG78nDyN6Uw2tWQx

Author: claude

README.md

@@ -530,7 +530,7 @@ For complete command and flag reference, see [REFERENCE.md](REFERENCE.md).
 
 ### Event Gateway MCP
 
-The CLI includes an [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server for investigating webhook traffic in production. It exposes read-only tools that let AI agents query your Hookdeck Event Gateway — inspect connections, trace requests through events and delivery attempts, review issues, and pull aggregate metrics.
+The CLI includes an [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server for investigating event traffic in production. It exposes read-only tools that let AI agents query your Hookdeck Event Gateway — inspect connections, trace requests through events and delivery attempts, review issues, and pull aggregate metrics.
 
 **Configure your MCP client** (Cursor, Claude Desktop, or any MCP-compatible host):
 
@@ -568,9 +568,9 @@ The client starts `hookdeck gateway mcp` as a stdio subprocess. If you haven't a
 |------|-------------|
 | `hookdeck_projects` | List projects or switch the active project for this session |
 | `hookdeck_connections` | Inspect connections and control delivery flow (list, get, pause, unpause) |
-| `hookdeck_sources` | Inspect inbound webhook sources |
-| `hookdeck_destinations` | Inspect webhook delivery destinations |
-| `hookdeck_transformations` | Inspect JavaScript transformations applied to payloads |
+| `hookdeck_sources` | Inspect inbound sources (HTTP endpoints that receive events) |
+| `hookdeck_destinations` | Inspect delivery destinations (HTTP endpoints where events are sent) |
+| `hookdeck_transformations` | Inspect JavaScript transformations applied to event payloads |
 | `hookdeck_requests` | Query inbound requests — list, get details, raw body, linked events |
 | `hookdeck_events` | Query processed events — list, get details, raw payload body |
 | `hookdeck_attempts` | Query delivery attempts — retry history, response codes, errors |
@@ -583,7 +583,7 @@ The client starts `hookdeck gateway mcp` as a stdio subprocess. If you haven't a
 Once the MCP server is configured, you can ask your agent questions like:
 
 ```
-"Are any of my webhooks failing right now?"
+"Are any of my events failing right now?"
 → Agent uses hookdeck_issues to list open issues, then hookdeck_events to inspect recent failures.
 
 "Show me the last 10 events for my Stripe source and check if any failed."
@@ -595,7 +595,7 @@ Once the MCP server is configured, you can ask your agent questions like:
 "Trace request req_abc123 — what events did it produce, and did they all deliver successfully?"
 → Agent uses hookdeck_requests to get the request, then the events action to list generated events.
 
-"Why is my checkout webhook returning 500s? Show me the latest attempt details."
+"Why is my checkout endpoint returning 500s? Show me the latest attempt details."
 → Agent uses hookdeck_events filtered by status FAILED, then hookdeck_attempts to inspect delivery details.
 
 "Pause the connection between Stripe and my staging endpoint while I debug."

pkg/gateway/mcp/tool_help.go

@@ -37,11 +37,11 @@ Current project: %s
 
 hookdeck_projects        — List or switch projects (actions: list, use)
 hookdeck_connections     — Inspect connections and control delivery flow (actions: list, get, pause, unpause)
-hookdeck_sources         — Inspect inbound webhook sources (actions: list, get)
-hookdeck_destinations    — Inspect webhook delivery destinations (actions: list, get)
+hookdeck_sources         — Inspect inbound sources (actions: list, get)
+hookdeck_destinations    — Inspect delivery destinations (actions: list, get)
 hookdeck_transformations — Inspect JavaScript transformations (actions: list, get)
-hookdeck_requests        — Query inbound webhook requests (actions: list, get, raw_body, events, ignored_events)
-hookdeck_events          — Query processed webhook events (actions: list, get, raw_body)
+hookdeck_requests        — Query inbound requests (actions: list, get, raw_body, events, ignored_events)
+hookdeck_events          — Query processed events (actions: list, get, raw_body)
 hookdeck_attempts        — Query delivery attempts (actions: list, get)
 hookdeck_issues          — Inspect aggregated failure signals (actions: list, get)
 hookdeck_metrics         — Query aggregate metrics (actions: events, requests, attempts, transformations)
@@ -81,7 +81,7 @@ Parameters:
   limit          (integer)          — Max results (list, default 100)
   next/prev      (string)           — Pagination cursors (list)`,
 
-	"hookdeck_sources": `hookdeck_sources — Inspect inbound webhook sources
+	"hookdeck_sources": `hookdeck_sources — Inspect inbound sources
 
 Actions:
   list — List sources with optional filters
@@ -94,7 +94,7 @@ Parameters:
   limit   (integer)          — Max results (list, default 100)
   next/prev (string)         — Pagination cursors (list)`,
 
-	"hookdeck_destinations": `hookdeck_destinations — Inspect webhook delivery destinations
+	"hookdeck_destinations": `hookdeck_destinations — Inspect delivery destinations
 
 Actions:
   list — List destinations with optional filters
@@ -120,7 +120,7 @@ Parameters:
   limit   (integer)          — Max results (list, default 100)
   next/prev (string)         — Pagination cursors (list)`,
 
-	"hookdeck_requests": `hookdeck_requests — Query inbound webhook requests
+	"hookdeck_requests": `hookdeck_requests — Query inbound requests
 
 Actions:
   list           — List requests with optional filters
@@ -139,7 +139,7 @@ Parameters:
   limit           (integer)          — Max results (list, default 100)
   next/prev       (string)           — Pagination cursors (list)`,
 
-	"hookdeck_events": `hookdeck_events — Query events (processed webhook deliveries)
+	"hookdeck_events": `hookdeck_events — Query events (processed deliveries)
 
 Actions:
   list     — List events with optional filters

pkg/gateway/mcp/tools.go

@@ -33,7 +33,7 @@ func toolDefs(client *hookdeck.Client) []struct {
 		{
 			tool: &mcpsdk.Tool{
 				Name:        "hookdeck_connections",
-				Description: "Inspect webhook connections (routes linking sources to destinations). List connections with filters, get details by ID, or pause/unpause a connection's delivery pipeline.",
+				Description: "Inspect connections (routes linking sources to destinations). List connections with filters, get details by ID, or pause/unpause a connection's delivery pipeline.",
 				InputSchema: schema(map[string]prop{
 					"action":         {Type: "string", Desc: "Action: list, get, pause, or unpause", Enum: []string{"list", "get", "pause", "unpause"}},
 					"id":             {Type: "string", Desc: "Connection ID (required for get/pause/unpause)"},
@@ -51,7 +51,7 @@ func toolDefs(client *hookdeck.Client) []struct {
 		{
 			tool: &mcpsdk.Tool{
 				Name:        "hookdeck_sources",
-				Description: "List and inspect inbound webhook sources. Returns source configuration including URL, verification settings, and allowed HTTP methods.",
+				Description: "List and inspect inbound sources (HTTP endpoints that receive events). Returns source configuration including URL, verification settings, and allowed HTTP methods.",
 				InputSchema: schema(map[string]prop{
 					"action": {Type: "string", Desc: "Action: list or get", Enum: []string{"list", "get"}},
 					"id":     {Type: "string", Desc: "Source ID (required for get)"},
@@ -66,7 +66,7 @@ func toolDefs(client *hookdeck.Client) []struct {
 		{
 			tool: &mcpsdk.Tool{
 				Name:        "hookdeck_destinations",
-				Description: "List and inspect webhook delivery destinations. Returns destination configuration including URL, authentication, and rate limiting settings.",
+				Description: "List and inspect delivery destinations (HTTP endpoints where events are sent). Returns destination configuration including URL, authentication, and rate limiting settings.",
 				InputSchema: schema(map[string]prop{
 					"action": {Type: "string", Desc: "Action: list or get", Enum: []string{"list", "get"}},
 					"id":     {Type: "string", Desc: "Destination ID (required for get)"},
@@ -81,7 +81,7 @@ func toolDefs(client *hookdeck.Client) []struct {
 		{
 			tool: &mcpsdk.Tool{
 				Name:        "hookdeck_transformations",
-				Description: "List and inspect JavaScript transformations applied to webhook payloads. Returns transformation code and configuration for debugging payload processing.",
+				Description: "List and inspect JavaScript transformations applied to event payloads. Returns transformation code and configuration for debugging payload processing.",
 				InputSchema: schema(map[string]prop{
 					"action": {Type: "string", Desc: "Action: list or get", Enum: []string{"list", "get"}},
 					"id":     {Type: "string", Desc: "Transformation ID (required for get)"},
@@ -96,7 +96,7 @@ func toolDefs(client *hookdeck.Client) []struct {
 		{
 			tool: &mcpsdk.Tool{
 				Name:        "hookdeck_requests",
-				Description: "Query inbound webhook requests (raw data received by Hookdeck before routing). List with filters, get details, inspect the raw body, or view the events and ignored events generated from a request.",
+				Description: "Query inbound requests (raw HTTP data received by Hookdeck before routing). List with filters, get details, inspect the raw body, or view the events and ignored events generated from a request.",
 				InputSchema: schema(map[string]prop{
 					"action":         {Type: "string", Desc: "Action: list, get, raw_body, events, or ignored_events", Enum: []string{"list", "get", "raw_body", "events", "ignored_events"}},
 					"id":             {Type: "string", Desc: "Request ID (required for get/raw_body/events/ignored_events)"},
@@ -114,7 +114,7 @@ func toolDefs(client *hookdeck.Client) []struct {
 		{
 			tool: &mcpsdk.Tool{
 				Name:        "hookdeck_events",
-				Description: "Query events (webhook deliveries routed through connections). List with filters by status, source, destination, or date range. Get event details or inspect the raw payload body.",
+				Description: "Query events (processed deliveries routed through connections to destinations). List with filters by status, source, destination, or date range. Get event details or inspect the raw payload body.",
 				InputSchema: schema(map[string]prop{
 					"action":          {Type: "string", Desc: "Action: list, get, or raw_body", Enum: []string{"list", "get", "raw_body"}},
 					"id":              {Type: "string", Desc: "Event ID (required for get/raw_body)"},
@@ -156,7 +156,7 @@ func toolDefs(client *hookdeck.Client) []struct {
 		{
 			tool: &mcpsdk.Tool{
 				Name:        "hookdeck_issues",
-				Description: "List and inspect Hookdeck issues — aggregated failure signals such as repeated delivery failures, transformation errors, and backpressure alerts. Use this to identify systemic problems across your webhooks.",
+				Description: "List and inspect Hookdeck issues — aggregated failure signals such as repeated delivery failures, transformation errors, and backpressure alerts. Use this to identify systemic problems across your event pipeline.",
 				InputSchema: schema(map[string]prop{
 					"action":           {Type: "string", Desc: "Action: list or get", Enum: []string{"list", "get"}},
 					"id":               {Type: "string", Desc: "Issue ID (required for get)"},