ESA MCP Server
by d-kimuson
- openapi-spec
{
"paths": {
"/v1/teams/{team_name}/posts/{post_number}/comments": {
"get": {
"tags": ["Comment"],
"summary": "List comments on a post",
"security": [{ "bearerAuth": [] }],
"parameters": [
{ "$ref": "./openapi.json#/components/parameters/teamName" },
{
"name": "post_number",
"in": "path",
"required": true,
"schema": { "type": "integer" }
}
],
"responses": {
"200": {
"description": "List of comments",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"comments": {
"type": "array",
"items": {
"$ref": "./openapi.json#/components/schemas/Comment"
}
}
},
"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"
}
}
}
},
"post": {
"tags": ["Comment"],
"summary": "Create a comment",
"security": [{ "bearerAuth": [] }],
"parameters": [
{ "$ref": "./openapi.json#/components/parameters/teamName" },
{
"name": "post_number",
"in": "path",
"required": true,
"schema": { "type": "integer" }
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"comment": {
"type": "object",
"required": ["body_md"],
"properties": {
"body_md": { "type": "string" },
"user": { "type": "string" }
}
}
}
}
}
}
},
"responses": {
"201": {
"description": "Created comment",
"content": {
"application/json": {
"schema": {
"$ref": "./openapi.json#/components/schemas/Comment"
}
}
}
},
"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}/comments/{comment_id}": {
"tags": ["Comment"],
"parameters": [
{ "$ref": "./openapi.json#/components/parameters/teamName" },
{
"name": "comment_id",
"in": "path",
"required": true,
"schema": { "type": "integer" }
}
],
"get": {
"tags": ["Comment"],
"summary": "Get a comment",
"security": [{ "bearerAuth": [] }],
"parameters": [
{
"name": "include",
"in": "query",
"schema": {
"type": "string",
"enum": ["stargazers"]
}
}
],
"responses": {
"200": {
"description": "Comment details",
"content": {
"application/json": {
"schema": {
"$ref": "./openapi.json#/components/schemas/Comment"
}
}
}
},
"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"
}
}
}
},
"patch": {
"tags": ["Comment"],
"summary": "Update a comment",
"security": [{ "bearerAuth": [] }],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"comment": {
"type": "object",
"properties": {
"body_md": { "type": "string" },
"user": { "type": "string" }
}
}
}
}
}
}
},
"responses": {
"200": {
"description": "Updated comment",
"content": {
"application/json": {
"schema": {
"$ref": "./openapi.json#/components/schemas/Comment"
}
}
}
},
"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": ["Comment"],
"summary": "Delete a comment",
"security": [{ "bearerAuth": [] }],
"responses": {
"204": { "description": "Comment deleted" },
"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}/comments": {
"get": {
"tags": ["Comment"],
"summary": "List all team comments",
"security": [{ "bearerAuth": [] }],
"parameters": [
{ "$ref": "./openapi.json#/components/parameters/teamName" }
],
"responses": {
"200": {
"description": "List of all comments",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"comments": {
"type": "array",
"items": {
"$ref": "./openapi.json#/components/schemas/Comment"
}
}
},
"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"
}
}
}
}
}
}
}