{"openapi":"3.0.3","info":{"title":"Gnist Context — Entity Monitors","description":"Create and manage entity monitors — watch specific entities for data changes and receive alerts via webhooks or Atom feeds.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/monitors/`\n- **Toolkit page:** `/toolkits/monitors`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/monitors/create_monitor":{"post":{"tags":["Platform"],"summary":"create_monitor","description":"Create an entity monitor to watch for data changes.\n\nWhen the monitored entity changes, an alert is generated and\ndelivered to your webhook subscriptions for that entity type.\n\nSet up a webhook subscription first (using the subscribe tool),\nthen create a monitor for the specific entity you want to watch.\n\nArgs:\n    api_key: Your Gnist API key.\n    entity_type: The type of entity to monitor.\n    entity_id: The specific entity identifier.\n\nReturns:\n    Monitor details including id, entity_type, and entity_id, or error.","operationId":"monitors_create_monitor","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"api_key":{"description":"Your Gnist API key (starts with 'gnist_').","type":"string"},"entity_type":{"description":"Entity type to monitor (e.g. 'brreg_company', 'doffin_tender', 'sec_edgar_filing').","type":"string"},"entity_id":{"description":"ID of the entity to monitor (e.g. org number, notice ID).","type":"string"}},"required":["api_key","entity_type","entity_id"],"type":"object"}}}}}},"/rest/monitors/list_monitors":{"post":{"tags":["Platform"],"summary":"list_monitors","description":"List all active entity monitors for your API key.\n\nReturns monitors with their entity type, entity ID, and status.\n\nArgs:\n    api_key: Your Gnist API key.\n\nReturns:\n    List of active monitors.","operationId":"monitors_list_monitors","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"api_key":{"description":"Your Gnist API key (starts with 'gnist_').","type":"string"}},"required":["api_key"],"type":"object"}}}}}},"/rest/monitors/delete_monitor":{"post":{"tags":["Platform"],"summary":"delete_monitor","description":"Remove an entity monitor (soft delete).\n\nThe monitor will stop generating alerts immediately.\n\nArgs:\n    api_key: Your Gnist API key.\n    monitor_id: The monitor UUID to deactivate.\n\nReturns:\n    Confirmation or error if monitor not found.","operationId":"monitors_delete_monitor","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"api_key":{"description":"Your Gnist API key (starts with 'gnist_').","type":"string"},"monitor_id":{"description":"UUID of the monitor to remove.","type":"string"}},"required":["api_key","monitor_id"],"type":"object"}}}}}},"/rest/monitors/list_monitor_alerts":{"post":{"tags":["Platform"],"summary":"list_monitor_alerts","description":"List alerts for an entity monitor, newest first.\n\nAlerts are generated when change detection finds new data\nfor the monitored entity.\n\nArgs:\n    api_key: Your Gnist API key.\n    monitor_id: The monitor UUID to list alerts for.\n    limit: Maximum alerts to return (1-200, default 50).\n\nReturns:\n    List of alerts with status and timestamps.","operationId":"monitors_list_monitor_alerts","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"api_key":{"description":"Your Gnist API key (starts with 'gnist_').","type":"string"},"monitor_id":{"description":"UUID of the monitor to list alerts for.","type":"string"},"limit":{"default":50,"description":"Maximum number of alerts to return.","maximum":200,"minimum":1,"type":"integer"}},"required":["api_key","monitor_id"],"type":"object"}}}}}},"/rest/monitors/report_feedback":{"post":{"tags":["Platform"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"monitors_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Platform","description":"Data sources: Platform"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}