sealgate-ai Events API
The events API from sealgate-ai — 3 operation(s) for events.
The events API from sealgate-ai — 3 operation(s) for events.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/sealgate-ai:sealgate-ai-events-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: SealGate Events API
description: Open-source MCP security, aggregation, and monitoring. Self-hosted MCP proxy.
version: 0.19.0
tags:
- name: Events
paths:
/api/v1/events:
get:
tags:
- Events
summary: SSE event stream
description: Server-Sent Events stream for real-time client events (tool calls, permission changes, approval requests). Supports auth via Authorization header or api_key query param.
operationId: sse_events_api_v1_events_get
parameters:
- name: api_key
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: API key (alternative to Authorization header)
title: Api Key
description: API key (alternative to Authorization header)
- name: source
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Client source identifier (e.g. 'desktop' for Electron app)
title: Source
description: Client source identifier (e.g. 'desktop' for Electron app)
responses:
'200':
description: SSE stream
content:
application/json:
schema: {}
text/event-stream: {}
'401':
description: Missing or invalid API key
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/events/dev/server-log:
post:
tags:
- Events
summary: Emit a synthetic mcp_server_log SSE event (dev only)
description: Fires a fake mcp_server_log event for the calling user so the dashboard's toast + notification bell can be tested end to end without breaking a real MCP server. Only available with EDISON_DEV=1.
operationId: dev_emit_server_log_api_v1_events_dev_server_log_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DevEmitServerLogRequest'
required: true
responses:
'200':
description: Event emitted
content:
application/json:
schema:
additionalProperties:
type: string
type: object
title: Response Dev Emit Server Log Api V1 Events Dev Server Log Post
'401':
description: Missing or invalid API key
'404':
description: Not available outside dev mode
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
parameters:
- name: Idempotency-Key
in: header
required: false
description: Optional client-generated key that makes this write operation safe to retry. Reusing the same key returns the original response instead of performing the operation a second time. Keys are scoped to the caller and expire after 24 hours.
schema:
type: string
maxLength: 255
/api/v1/admin/logs/stream:
get:
tags:
- Events
summary: SSE admin log stream
description: Server-Sent Events stream for real-time server logs (OWNER only). Supports auth via Authorization header or api_key query param. Optional server-side filters for log level and source.
operationId: admin_logs_stream_api_v1_admin_logs_stream_get
parameters:
- name: api_key
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: API key (alternative to Authorization header)
title: Api Key
description: API key (alternative to Authorization header)
- name: level
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'Filter by min log level: DEBUG, INFO, WARNING, ERROR, CRITICAL'
title: Level
description: 'Filter by min log level: DEBUG, INFO, WARNING, ERROR, CRITICAL'
- name: source
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: 'Filter by source: http (access logs) or app (application logs)'
title: Source
description: 'Filter by source: http (access logs) or app (application logs)'
responses:
'200':
description: SSE log stream
content:
application/json:
schema: {}
text/event-stream: {}
'401':
description: Missing or invalid API key
'403':
description: Insufficient permissions (requires OWNER)
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
DevEmitServerLogRequest:
properties:
server_name:
type: string
title: Server Name
default: dev-test-server
level:
type: string
enum:
- warning
- error
title: Level
default: warning
title:
type: string
title: Title
default: Server not responding (timed out)
lines:
items:
type: string
type: array
title: Lines
category:
type: string
enum:
- health
- startup
title: Category
default: startup
type: object
title: DevEmitServerLogRequest
description: Synthetic mcp_server_log payload for local testing.
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
ClientBearer:
type: http
description: Opaque ewc_ client installation credential
scheme: bearer
ServiceToken:
type: http
description: 'A SealGate service token: `sgt_acct_...` (account token) or `sgt_org_...` (org token). Mint an account token in the dashboard.'
scheme: bearer
MCPGatewayOAuth:
type: oauth2
description: OAuth 2.1 authorization-code flow (PKCE required) against the SealGate MCP gateway's authorization server. Request only the scopes an agent needs; unrequested scopes are not granted.
flows:
authorizationCode:
authorizationUrl: /oauth/authorize
tokenUrl: /oauth/token
refreshUrl: /oauth/token
scopes:
mcp: Connect to the MCP gateway and call the tools exposed by your enabled servers. Every call is still evaluated by the policy engine.
offline_access: Issue a refresh token so the client can renew access without a new browser sign-in.