Skip to main content
Skip to main content
Get free API key →

GitHub Webhooks#

Connect your GitHub repository to auto-compress documentation and code on push events. When a PR is opened, gotcontext compresses the diff and posts a comment with token savings. Configure in Settings > Integrations.

Setup

Enter your GitHub Personal Access Token, webhook secret, and repo URL in the Integrations settings tab.

Webhook events

push — triggers file compression on new commits.

pull_request — triggers diff compression + a PR comment with token savings.

Every incoming webhook is verified with HMAC-SHA256 signature validation.

MCP Tool Compression#

Requires Team or Enterprise plan.

Compress MCP tool descriptions to reduce token usage by 50–80%. Two tools are available:

compress_mcp_registry

Batch compress all tool descriptions from one or more MCP servers.

proxy_mcp_server

Proxy any MCP call through compression — transparently reduces tool description tokens for downstream consumers.

Webhooks#

Outbound webhooks deliver signed JSON payloads to your endpoint when compression events fire. Currently supported events: compression.completed.

Each delivery includes an X-GotContext-Signature HMAC-SHA256 header keyed off the secret returned at create time. Failed deliveries auto-retry with exponential backoff (3 attempts over ~10 min). Manage at /dashboard/webhooks or via POST /v1/webhooks.

Integrations#

GitHub integration: configure a repository webhook pointing at https://api.gotcontext.ai/v1/integrations/github/webhook with the secret from Settings → Integrations. Push events trigger automatic compression of the changed files so your CI assistant inherits a smaller context window.

Verify with HMAC-SHA256 against the X-Hub-Signature-256 header. Plain-text webhooks and unsigned events are rejected.

Where to next

Quickstart
Connect your MCP client and run your first compression in under two minutes.
Recipes
Copy-paste tool sequences for the workflows you'll run most.
Troubleshooting
Symptom-to-fix for the errors people actually hit.
Glossary
Plain-language definitions for skeleton, fidelity, profiles, and the rest.