sealgate-ai Mcp Requests API
The Mcp Requests API from sealgate-ai — 2 operation(s) for mcp requests.
The Mcp Requests API from sealgate-ai — 2 operation(s) for mcp requests.
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-mcp-requests-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 Mcp Requests API
description: Open-source MCP security, aggregation, and monitoring. Self-hosted MCP proxy.
version: 0.19.0
tags:
- name: Mcp Requests
paths:
/api/v1/mcp-requests:
get:
summary: List My Requests
description: List the current user's MCP server requests.
operationId: list_my_requests_api_v1_mcp_requests_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/McpRequestListResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Mcp Requests
post:
summary: Create Request
description: 'Submit a new MCP server permission request.
Thin adapter over :func:`src.mcp_server_requests.submit_mcp_server_request`
(the shared service core, also driven by the ``builtin_register_new_mcp_url``
chat tool).'
operationId: create_request_api_v1_mcp_requests_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/CreateMcpRequestBody'
responses:
'201':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CreateMcpRequestResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Mcp Requests
/api/v1/mcp-requests/{request_id}:
delete:
summary: Withdraw Request
description: Withdraw a pending MCP server request.
operationId: withdraw_request_api_v1_mcp_requests__request_id__delete
security:
- HTTPBearer: []
parameters:
- name: request_id
in: path
required: true
schema:
type: integer
title: Request 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:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/WithdrawMcpRequestResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
tags:
- Mcp Requests
components:
schemas:
McpRequestListResponse:
properties:
requests:
items:
$ref: '#/components/schemas/McpRequestEntry'
type: array
title: Requests
description: List of MCP server requests
type: object
required:
- requests
title: McpRequestListResponse
CreateMcpRequestBody:
properties:
name:
type: string
title: Name
description: Proposed server name
display_name:
anyOf:
- type: string
- type: 'null'
title: Display Name
description: Human-readable server label
command:
anyOf:
- type: string
- type: 'null'
title: Command
description: Command for stdio servers
args:
items: {}
type: array
title: Args
description: Command-line arguments
env:
additionalProperties:
type: string
type: object
title: Env
description: Environment variables
url:
anyOf:
- type: string
- type: 'null'
title: Url
description: URL for HTTP/SSE servers
headers:
anyOf:
- additionalProperties:
type: string
type: object
- type: 'null'
title: Headers
description: Custom HTTP headers for HTTP/SSE servers
type:
anyOf:
- type: string
- type: 'null'
title: Type
description: 'Server type: stdio, sse, http'
hostname:
anyOf:
- type: string
- type: 'null'
title: Hostname
description: Machine the server was discovered on. Sent by the detector daemon for local (stdio) servers so approval can resolve the stdiod device and gate on it being online.
source_app:
anyOf:
- type: string
- type: 'null'
title: Source App
description: App where server was discovered
source_path:
anyOf:
- type: string
- type: 'null'
title: Source Path
description: Config file path
roots:
items:
type: string
type: array
title: Roots
description: Root paths
from_marketplace_id:
anyOf:
- type: string
- type: 'null'
title: From Marketplace Id
description: Marketplace ID
justification:
anyOf:
- type: string
- type: 'null'
title: Justification
description: Reason for request
template_fields:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Template Fields
description: Template field definitions for detected secrets
origin:
anyOf:
- type: string
enum:
- quarantine_watcher
- dashboard
- type: 'null'
title: Origin
description: Where the request was raised. 'dashboard' for a request a user filed by hand in the dashboard (My Connectors, marketplace, /add-mcp); it is never quarantined and lands in the new-server-requests queue. Omitted means 'quarantine_watcher' (the desktop client's detector), so clients that predate this field keep landing in the quarantine queue while the org's auto-quarantine flag is on.
type: object
required:
- name
title: CreateMcpRequestBody
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
WithdrawMcpRequestResponse:
properties:
status:
type: string
title: Status
description: Operation result
default: success
message:
type: string
title: Message
description: Human-readable message
default: Request withdrawn successfully
type: object
title: WithdrawMcpRequestResponse
McpRequestEntry:
properties:
id:
type: integer
title: Id
description: Request ID
requester_user_id:
type: string
title: Requester User Id
description: Requester user UUID
name:
type: string
title: Name
description: Proposed server name
display_name:
anyOf:
- type: string
- type: 'null'
title: Display Name
description: Human-readable server label
command:
anyOf:
- type: string
- type: 'null'
title: Command
description: Command for stdio servers
args:
items: {}
type: array
title: Args
description: Command-line arguments
env:
additionalProperties:
type: string
type: object
title: Env
description: Environment variables
url:
anyOf:
- type: string
- type: 'null'
title: Url
description: URL for HTTP/SSE servers
headers:
additionalProperties:
type: string
type: object
title: Headers
description: Custom HTTP headers for HTTP/SSE servers
server_type:
type: string
title: Server Type
description: 'Server type: stdio, sse, or http'
default: stdio
source_app:
anyOf:
- type: string
- type: 'null'
title: Source App
description: App where server was discovered
source_path:
anyOf:
- type: string
- type: 'null'
title: Source Path
description: Config file path
roots:
items:
type: string
type: array
title: Roots
description: Root paths
from_marketplace_id:
anyOf:
- type: string
- type: 'null'
title: From Marketplace Id
description: Marketplace ID
justification:
anyOf:
- type: string
- type: 'null'
title: Justification
description: User's reason for requesting
template_fields:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Template Fields
description: Template field definitions
status:
type: string
title: Status
description: 'Request status: pending, approved, rejected'
default: pending
quarantined:
type: boolean
title: Quarantined
description: True if a non-admin raised the request while the org's auto-quarantine flag was on. Requests filed from the dashboard (origin 'dashboard') are never quarantined. Distinguishes the dashboard's quarantine queue from the new-server-requests queue.
default: false
reviewer_user_id:
anyOf:
- type: string
- type: 'null'
title: Reviewer User Id
description: Reviewer user UUID
reviewer_notes:
anyOf:
- type: string
- type: 'null'
title: Reviewer Notes
description: Reviewer notes
icon_url:
anyOf:
- type: string
- type: 'null'
title: Icon Url
description: Brand icon URL (e.g. logo.dev) resolved from the server URL at submission time, for rendering in the pending-requests list. Null when no logo could be derived.
hostname:
anyOf:
- type: string
- type: 'null'
title: Hostname
description: Machine the server was discovered on (local/stdio requests)
device_status:
anyOf:
- type: string
- type: 'null'
title: Device Status
description: 'Online status of the host''s stdiod device for a stdio request: ''online'', ''offline'', or ''unknown''. Null for HTTP/SSE requests. The Approve action is only allowed when this is ''online''.'
created_at:
anyOf:
- type: string
- type: 'null'
title: Created At
description: Creation timestamp (ISO 8601)
updated_at:
anyOf:
- type: string
- type: 'null'
title: Updated At
description: Last update timestamp (ISO 8601)
type: object
required:
- id
- requester_user_id
- name
title: McpRequestEntry
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
CreateMcpRequestResponse:
properties:
status:
type: string
title: Status
description: Operation result
default: success
message:
type: string
title: Message
description: Human-readable message
request_id:
type: integer
title: Request Id
description: Created request ID
auto_approved:
type: boolean
title: Auto Approved
description: True if the backend immediately approved the request (admin/owner submitter). Clients should skip any follow-up approve call when this is set.
default: false
type: object
required:
- message
- request_id
title: CreateMcpRequestResponse
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.