Platform
Data source: Internal
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/webhooks/
claude_desktop_config.json
{
"mcpServers": {
"gnist-webhooks": {
"url": "https://context.gnist.ai/mcp/webhooks/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/webhooks/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "subscribe", "arguments": {"api_key": "example", "entity_type": "example", "callback_url": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/webhooks/
7 endpoints available:
GET /rest/webhooks/subscribeGET /rest/webhooks/unsubscribeGET /rest/webhooks/list_subscriptionsGET /rest/webhooks/reset_subscriptionGET /rest/webhooks/list_deliveriesGET /rest/webhooks/get_webhook_metricsGET /rest/webhooks/report_feedback
Shell
curl "https://context.gnist.ai/rest/webhooks/subscribe?api_key=example&entity_type=example&callback_url=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/webhooks/subscribe",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"api_key": "example",
"entity_type": "example",
"callback_url": "example"
},
)
print(resp.json())
Command Line
Command
gc webhooks
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (7)
subscribeCreate a webhook subscription for data change notifications.
| Parameter | Type | Required | Description |
|---|---|---|---|
api_key | string | required | Your Gnist API key (starts with 'gnist_'). |
entity_type | string | required | Entity type to subscribe to (e.g. 'brreg_company', 'doffin_tender'). |
callback_url | string | required | HTTPS URL where webhook events will be delivered. |
unsubscribeRemove a webhook subscription (soft delete).
| Parameter | Type | Required | Description |
|---|---|---|---|
api_key | string | required | Your Gnist API key (starts with 'gnist_'). |
subscription_id | string | required | UUID of the subscription to remove. |
list_subscriptionsList all active webhook subscriptions for your API key.
| Parameter | Type | Required | Description |
|---|---|---|---|
api_key | string | required | Your Gnist API key (starts with 'gnist_'). |
reset_subscriptionReset a subscription's circuit breaker.
| Parameter | Type | Required | Description |
|---|---|---|---|
api_key | string | required | Your Gnist API key (starts with 'gnist_'). |
subscription_id | string | required | UUID of the subscription to reset. |
list_deliveriesList recent webhook deliveries.
| Parameter | Type | Required | Description |
|---|---|---|---|
api_key | string | required | Your Gnist API key (starts with 'gnist_'). |
subscription_id | any | optional | Filter to a specific subscription UUID. Omit for all subscriptions. |
limit | integer | optional | Maximum number of deliveries to return. (default: 50) |
get_webhook_metricsGet webhook delivery metrics.
| Parameter | Type | Required | Description |
|---|---|---|---|
api_key | string | required | Your Gnist API key (starts with 'gnist_'). |
subscription_id | any | optional | Filter to a specific subscription UUID. Omit for all subscriptions. |
hours | integer | optional | Time window in hours (default 24, max 720). (default: 24) |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |