sealgate-ai Stdio Tunnel API
The Stdio Tunnel API from sealgate-ai — 5 operation(s) for stdio tunnel.
The Stdio Tunnel API from sealgate-ai — 5 operation(s) for stdio tunnel.
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-stdio-tunnel-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 Stdio Tunnel API
description: Open-source MCP security, aggregation, and monitoring. Self-hosted MCP proxy.
version: 0.19.0
tags:
- name: Stdio Tunnel
paths:
/api/v1/stdio-tunnel/leases:
get:
summary: List Leases
description: Unexpired exclusive-server leases in the caller's org.
operationId: list_leases_api_v1_stdio_tunnel_leases_get
security:
- HTTPBearer: []
parameters:
- name: domain
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Org to view (Super-Owner only, read-only)
title: Domain
description: Org to view (Super-Owner only, read-only)
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ListLeasesResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Stdio Tunnel
/api/v1/stdio-tunnel/leases/release:
post:
summary: Release Lease
description: Release a lease - your own, or (``force`` + admin) anyone's.
operationId: release_lease_api_v1_stdio_tunnel_leases_release_post
security:
- HTTPBearer: []
parameters:
- name: domain
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Org to view (Super-Owner only, read-only)
title: Domain
description: Org to view (Super-Owner only, read-only)
- 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
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ReleaseLeaseRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ReleaseLeaseResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Stdio Tunnel
/api/v1/devices:
get:
tags:
- Stdio Tunnel
summary: List Devices
description: List devices for the caller's org. Admin-scoped via get_current_user.
operationId: list_devices_api_v1_devices_get
security:
- HTTPBearer: []
parameters:
- name: domain
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Org to view (Super-Owner only, read-only)
title: Domain
description: Org to view (Super-Owner only, read-only)
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ListDevicesResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/devices/{device_ref_id}:
delete:
tags:
- Stdio Tunnel
summary: Delete Device
description: Remove a device and its bound stdio_tunnel servers for the caller's org.
operationId: delete_device_api_v1_devices__device_ref_id__delete
security:
- HTTPBearer: []
parameters:
- name: device_ref_id
in: path
required: true
schema:
type: integer
title: Device Ref Id
- name: domain
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Org to view (Super-Owner only, read-only)
title: Domain
description: Org to view (Super-Owner only, read-only)
responses:
'204':
description: Successful Response
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/devices/{device_ref_id}/migrate:
post:
tags:
- Stdio Tunnel
summary: Migrate Device Servers
description: 'Repoint a retired device''s stdio servers at its replacement row.
Servers are bound to `Devices.id`, so a machine that re-registered under a
new device row leaves its servers pointing at the old one: invisible to the
daemon and still holding their names. Deleting the old device would drop
them; this moves them instead, names untouched.'
operationId: migrate_device_servers_api_v1_devices__device_ref_id__migrate_post
security:
- HTTPBearer: []
parameters:
- name: device_ref_id
in: path
required: true
schema:
type: integer
title: Device Ref Id
- name: domain
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Org to view (Super-Owner only, read-only)
title: Domain
description: Org to view (Super-Owner only, read-only)
- 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
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/MigrateDeviceRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/MigrateDeviceResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ListLeasesResponse:
properties:
leases:
items:
$ref: '#/components/schemas/LeaseSummary'
type: array
title: Leases
type: object
required:
- leases
title: ListLeasesResponse
ReleaseLeaseRequest:
properties:
device_ref_id:
type: integer
title: Device Ref Id
server_name:
type: string
title: Server Name
force:
type: boolean
title: Force
description: Release someone else's lease. Requires an admin role.
default: false
type: object
required:
- device_ref_id
- server_name
title: ReleaseLeaseRequest
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
ReleaseLeaseResponse:
properties:
released:
type: boolean
title: Released
holder_user_id:
anyOf:
- type: string
- type: 'null'
title: Holder User Id
type: object
required:
- released
title: ReleaseLeaseResponse
LeaseSummary:
properties:
device_ref_id:
type: integer
title: Device Ref Id
server_name:
type: string
title: Server Name
user_id:
type: string
title: User Id
user_email:
anyOf:
- type: string
- type: 'null'
title: User Email
acquired_at:
type: string
title: Acquired At
last_call_at:
type: string
title: Last Call At
type: object
required:
- device_ref_id
- server_name
- user_id
- acquired_at
- last_call_at
title: LeaseSummary
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
DeviceSummary:
properties:
id:
type: integer
title: Id
description: Surrogate ``Devices.id``. Authoritative identifier - frontend passes this back as ``device_ref_id`` when creating a stdio_tunnel server.
device_id:
type: string
title: Device Id
description: Wire-level device label the daemon advertises (hostname by default). Not unique across users sharing a machine; use ``id`` for any binding.
label:
type: string
title: Label
hostname:
type: string
title: Hostname
os:
type: string
title: Os
client_version:
type: string
title: Client Version
status:
type: string
title: Status
description: 'One of: online, offline, disabled.'
current_user:
type: boolean
title: Current User
description: True iff this Devices row represents a daemon identity that has signed in. Live status is resolved independently by row id.
default: false
last_seen_at:
anyOf:
- type: string
- type: 'null'
title: Last Seen At
scope:
type: string
title: Scope
description: '''personal'' (default): only the owning user may access this device''s stdio_tunnel servers. ''shared'': org infrastructure - its servers use normal org access control. Mutated via PATCH /devices/{id}/scope (admin + step-up).'
default: personal
server_count:
type: integer
title: Server Count
default: 0
servers:
items:
type: string
type: array
title: Servers
description: Names of the stdio_tunnel MCP servers bound to this device, sorted alphabetically. ``server_count`` is ``len(servers)``; both are kept so existing callers reading the count don't break.
user_id:
anyOf:
- type: string
- type: 'null'
title: User Id
description: The Supabase user_id of the daemon owner.
user_email:
anyOf:
- type: string
- type: 'null'
title: User Email
description: Email of the daemon owner, resolved from user_id. Lets admins tell which device belongs to whom.
type: object
required:
- id
- device_id
- label
- hostname
- os
- client_version
- status
title: DeviceSummary
MigrateDeviceRequest:
properties:
target_device_ref_id:
type: integer
title: Target Device Ref Id
description: Devices.id of the live row that should own the servers.
force:
type: boolean
title: Force
description: Proceed even when the two rows look like different machines. The comparison is a guard against mistakes, not proof of identity.
default: false
type: object
required:
- target_device_ref_id
title: MigrateDeviceRequest
description: Move a retired device's stdio servers onto its replacement row.
MigrateDeviceResponse:
properties:
detail:
type: string
title: Detail
servers_moved:
type: integer
title: Servers Moved
default: 0
type: object
required:
- detail
title: MigrateDeviceResponse
description: Result of moving one device's stdio servers onto another device row.
ListDevicesResponse:
properties:
devices:
items:
$ref: '#/components/schemas/DeviceSummary'
type: array
title: Devices
type: object
required:
- devices
title: ListDevicesResponse
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.