webhooks_manage
ActiveTool of @gapup/mcp-knowledge
declared in 0.2.0
Manage HTTP webhook callbacks for async tools (T5/T6 batch flagships). Instead of polling every 5s, register a callback URL — Gapup posts the job result to your endpoint the moment it completes. Supported events: job.completed | job.failed | monitoring.alert | quota.threshold. Modes: register (add endpoint), list (view active webhooks), revoke (soft-delete), test (fire a test payload to verify your receiver), history (last 20 fires). Security: every delivery is signed with HMAC-SHA256 on the body — verify the X-Gapup-Signature header against sha256(secret, body).
Parameters schema
{
"type": "object",
"required": [
"mode"
],
"properties": {
"url": {
"type": "string",
"description": "(register) HTTPS/HTTP endpoint that will receive POST callbacks. Must return 2xx within 10s."
},
"mode": {
"enum": [
"register",
"list",
"revoke",
"test",
"history"
],
"type": "string",
"description": "register — add a webhook endpoint. list — view your active webhooks. revoke — soft-delete a webhook by webhook_id. test — fire a test payload to verify the receiver is alive. history — last 20 delivery attempts for a webhook."
},
"async": {
"type": "boolean",
"description": "If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts."
},
"events": {
"type": "array",
"items": {
"enum": [
"job.completed",
"job.failed",
"monitoring.alert",
"quota.threshold"
],
"type": "string"
},
"description": "(register, optional) Events to subscribe to. Defaults to all events if omitted."
},
"secret": {
"type": "string",
"description": "(register, optional) A secret string used to sign deliveries with HMAC-SHA256. Store it safely — verify X-Gapup-Signature header on your receiver."
},
"webhook_id": {
"type": "string",
"description": "(revoke / test / history) The webhook_id returned from register."
},
"caller_hash": {
"type": "string",
"description": "Optional caller identity override. If omitted, uses the internal session hash."
}
}
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
@gapup/mcp-knowledge
https://github.com/getgapup/gapup-mcp
2/7 registries