API
/web_api/mcp_server_snapshot/search
/web_api/mcp_server_snapshot/search
This page is built from the JSON Schema snapshot in the documentation repository. The snapshot is updated by a separate command from the main app catalog and is not rewritten when the site is built.
Request
main-app://schemas/api_mcp_testing/mcp_server_snapshot/search.request.json
REQUEST /web_api/mcp_server_snapshot/search
| Name | Type | Required | Constraint |
|---|---|---|---|
filters | array of object | No | - |
options | object | No | no other fields |
response | any | No | - |
Other top-level fields are not allowed.
filters[]
| Name | Type | Required | Constraint |
|---|---|---|---|
object | object | Yes | no other fields |
operator | enum | Yes | "LIKE", "NOT_LIKE", "EQUAL", "NOT_EQUAL", "GT", "GTE", "LT", "LTE", "IN", "NOT_IN", "IS_NULL", "IS_NOT_NULL" |
value | any | No | - |
filters[].object
| Name | Type | Required | Constraint |
|---|---|---|---|
element | string | Yes | - |
attribute | string | Yes | - |
options
| Name | Type | Required | Constraint |
|---|---|---|---|
limit | integer | No | minimum 1 |
order | object | No | no other fields |
add | array of string | No | - |
options.order
| Name | Type | Required | Constraint |
|---|---|---|---|
attribute | enum | Yes | "mcp_server_snapshot_id", "mcp_server_id", "team_id", "project_id", "snapshot_status", "protocol_revision", "snapshot_transport", "mcp_server_auth_kind", "snapshot_completeness", "catalog_hash", "server_name", "server_version", "instructions", "client_name", "client_version", "protocol_adapter_version", "redaction_policy_version", "credential_generation", "access_subject", "captured_at", "fixed_at", "created_by_user_id", "created_at", "updated_at" |
direction | enum | No | "ASC", "DESC" |
Response
main-app://schemas/api_mcp_testing/mcp_server_snapshot/search.response.json
RESPONSE /web_api/mcp_server_snapshot/search
| Name | Type | Required | Constraint |
|---|---|---|---|
api_code | integer | Yes | const 200 |
api_result | array of object | boolean | Yes | - |
empty | boolean | No | - |
Other top-level fields are not allowed.
Source schema
The files below are copied from the snapshot unchanged. A $ref fragment is a separate block. The schemas are not merged.
Request: main-app://schemas/api_mcp_testing/mcp_server_snapshot/search.request.json
json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "main-app://schemas/api_mcp_testing/mcp_server_snapshot/search.request.json",
"title": "REQUEST /web_api/mcp_server_snapshot/search",
"$comment": "Generated from the DB model structure_scheme. Edit the model, then run node fill-from-structure-scheme.mjs.",
"type": "object",
"additionalProperties": false,
"description": "Empty result is api_result false, not []. mcp_server_snapshot_id GT the last mcp_server_snapshot_id, with options.order on mcp_server_snapshot_id ASC, is the next page. Repeat the other filters. There is no offset.",
"properties": {
"filters": {
"type": "array",
"items": {
"type": "object",
"required": [
"object",
"operator"
],
"additionalProperties": false,
"properties": {
"object": {
"type": "object",
"required": [
"element",
"attribute"
],
"additionalProperties": false,
"properties": {
"element": {
"type": "string"
},
"attribute": {
"type": "string",
"description": "Column of this element: mcp_server_snapshot_id, mcp_server_id, team_id, project_id, snapshot_status, protocol_revision, snapshot_transport, mcp_server_auth_kind, snapshot_completeness, catalog_hash, server_name, server_version, instructions, client_name, client_version, protocol_adapter_version, redaction_policy_version, credential_generation, access_subject, captured_at, fixed_at, created_by_user_id, created_at, updated_at. A custom property filter uses object.element custom and object.attribute equal to the property key."
}
}
},
"operator": {
"type": "string",
"enum": [
"LIKE",
"NOT_LIKE",
"EQUAL",
"NOT_EQUAL",
"GT",
"GTE",
"LT",
"LTE",
"IN",
"NOT_IN",
"IS_NULL",
"IS_NOT_NULL"
]
},
"value": true
}
}
},
"options": {
"type": "object",
"additionalProperties": false,
"properties": {
"limit": {
"type": "integer",
"minimum": 1
},
"order": {
"type": "object",
"required": [
"attribute"
],
"additionalProperties": false,
"properties": {
"attribute": {
"type": "string",
"enum": [
"mcp_server_snapshot_id",
"mcp_server_id",
"team_id",
"project_id",
"snapshot_status",
"protocol_revision",
"snapshot_transport",
"mcp_server_auth_kind",
"snapshot_completeness",
"catalog_hash",
"server_name",
"server_version",
"instructions",
"client_name",
"client_version",
"protocol_adapter_version",
"redaction_policy_version",
"credential_generation",
"access_subject",
"captured_at",
"fixed_at",
"created_by_user_id",
"created_at",
"updated_at"
]
},
"direction": {
"type": "string",
"enum": [
"ASC",
"DESC"
]
}
}
},
"add": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"response": true
}
}Response: main-app://schemas/api_mcp_testing/mcp_server_snapshot/search.response.json
json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "main-app://schemas/api_mcp_testing/mcp_server_snapshot/search.response.json",
"title": "RESPONSE /web_api/mcp_server_snapshot/search",
"$comment": "Generated from the DB model structure_scheme. Edit the model, then run node fill-from-structure-scheme.mjs.",
"allOf": [
{
"$ref": "main-app://schemas/_shared/envelope-success.json"
},
{
"type": "object",
"properties": {
"api_result": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "main-app://schemas/api_mcp_testing/mcp_server_snapshot/row.json"
}
},
{
"const": false
}
]
}
}
}
]
}Fragment: main-app://schemas/_shared/envelope-success.json
json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "main-app://schemas/_shared/envelope-success.json",
"title": "Canonical success envelope",
"type": "object",
"required": ["api_code", "api_result"],
"properties": {
"api_code": { "const": 200 },
"api_result": true,
"empty": { "type": "boolean" }
},
"additionalProperties": false
}Fragment: main-app://schemas/api_mcp_testing/mcp_server_snapshot/row.json
json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "main-app://schemas/api_mcp_testing/mcp_server_snapshot/row.json",
"title": "Row mcp_server_snapshot",
"$comment": "Generated from the DB model structure_scheme. Edit the model, then run node fill-from-structure-scheme.mjs.",
"type": "object",
"additionalProperties": true,
"properties": {
"mcp_server_snapshot_id": {
"type": "integer",
"minimum": 0
},
"mcp_server_id": {
"type": "integer",
"minimum": 0
},
"team_id": {
"type": "integer",
"minimum": 0
},
"project_id": {
"type": "integer",
"minimum": 0
},
"snapshot_status": {
"type": "string",
"enum": [
"DRAFT",
"FIXED"
]
},
"protocol_revision": {
"type": "string"
},
"snapshot_transport": {
"type": "string",
"enum": [
"STREAMABLE_HTTP"
]
},
"mcp_server_auth_kind": {
"type": "string",
"enum": [
"BEARER",
"OAUTH"
]
},
"snapshot_completeness": {
"type": "string",
"enum": [
"COMPLETE_UNVERIFIED",
"INCOMPLETE",
"ERROR"
]
},
"catalog_hash": {
"type": "string"
},
"server_name": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"server_version": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"instructions": {
"type": [
"string",
"null"
]
},
"client_name": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"client_version": {
"type": [
"string",
"null"
],
"maxLength": 255
},
"protocol_adapter_version": {
"type": "string",
"maxLength": 128
},
"redaction_policy_version": {
"type": "string",
"maxLength": 32
},
"credential_generation": {
"type": "integer",
"minimum": 0
},
"access_subject": {
"type": [
"string",
"null"
],
"maxLength": 512
},
"captured_at": {
"type": "string",
"description": "timestamp Y-m-d H:i:s"
},
"fixed_at": {
"type": "string",
"description": "timestamp Y-m-d H:i:s"
},
"created_by_user_id": {
"type": "integer",
"minimum": 0
},
"created_at": {
"type": "string",
"description": "timestamp Y-m-d H:i:s"
},
"updated_at": {
"type": "string",
"description": "timestamp Y-m-d H:i:s"
}
}
}Did this page help?