ESA MCP Server
by d-kimuson
- openapi-spec
{
"paths": {
"/v1/teams/{team_name}/posts/{post_number}/watchers": {
"get": {
"tags": ["Watch"],
"summary": "List post watchers",
"security": [{ "bearerAuth": [] }],
"parameters": [
{ "$ref": "./openapi.json#/components/parameters/teamName" },
{
"name": "post_number",
"in": "path",
"required": true,
"schema": { "type": "integer" }
}
],
"responses": {
"200": {
"description": "List of watchers",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"watchers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"created_at": {
"type": "string",
"format": "date-time"
},
"user": {
"$ref": "./openapi.json#/components/schemas/User"
}
}
}
}
},
"allOf": [
{ "$ref": "./openapi.json#/components/schemas/Pagination" }
]
}
}
}
},
"400": {
"content": {
"$ref": "./openapi.json#/components/schemas/ErrorResponseBody"
}
},
"401": {
"content": {
"$ref": "./openapi.json#/components/schemas/ErrorResponseBody"
}
},
"404": {
"content": {
"$ref": "./openapi.json#/components/schemas/ErrorResponseBody"
}
},
"409": {
"content": {
"$ref": "./openapi.json#/components/schemas/ErrorResponseBody"
}
},
"429": {
"content": {
"$ref": "./openapi.json#/components/schemas/ErrorResponseBody"
}
}
}
}
},
"/v1/teams/{team_name}/posts/{post_number}/watch": {
"post": {
"tags": ["Watch"],
"summary": "Watch a post",
"security": [{ "bearerAuth": [] }],
"parameters": [
{ "$ref": "./openapi.json#/components/parameters/teamName" },
{
"name": "post_number",
"in": "path",
"required": true,
"schema": { "type": "integer" }
}
],
"responses": {
"204": { "description": "Post watched" },
"400": {
"content": {
"$ref": "./openapi.json#/components/schemas/ErrorResponseBody"
}
},
"401": {
"content": {
"$ref": "./openapi.json#/components/schemas/ErrorResponseBody"
}
},
"404": {
"content": {
"$ref": "./openapi.json#/components/schemas/ErrorResponseBody"
}
},
"409": {
"content": {
"$ref": "./openapi.json#/components/schemas/ErrorResponseBody"
}
},
"429": {
"content": {
"$ref": "./openapi.json#/components/schemas/ErrorResponseBody"
}
}
}
},
"delete": {
"tags": ["Watch"],
"summary": "Unwatch a post",
"security": [{ "bearerAuth": [] }],
"parameters": [
{ "$ref": "./openapi.json#/components/parameters/teamName" },
{
"name": "post_number",
"in": "path",
"required": true,
"schema": { "type": "integer" }
}
],
"responses": {
"204": { "description": "Watch removed" },
"400": {
"content": {
"$ref": "./openapi.json#/components/schemas/ErrorResponseBody"
}
},
"401": {
"content": {
"$ref": "./openapi.json#/components/schemas/ErrorResponseBody"
}
},
"404": {
"content": {
"$ref": "./openapi.json#/components/schemas/ErrorResponseBody"
}
},
"409": {
"content": {
"$ref": "./openapi.json#/components/schemas/ErrorResponseBody"
}
},
"429": {
"content": {
"$ref": "./openapi.json#/components/schemas/ErrorResponseBody"
}
}
}
}
}
}
}