BitSight Community MCP Server

{ "paths": { "/news": { "get": { "description": "Endpoint for fetching the news for everything", "operationId": "listNews", "parameters": [ { "$ref": "#/components/parameters/Sort" }, { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Offset" }, { "description": "whether it will be displayed on the portfolio dashboard", "in": "query", "name": "show_on_dashboard", "required": false, "schema": { "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/x-common-definitions/paginated_result", "properties": { "results": { "items": { "$ref": "#/components/schemas/News" }, "type": "array" } } } } }, "description": "OK" }, "500": { "$ref": "#/components/responses/InternalServerError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } } } }, "/notifications": { "get": { "description": "List of all portal notifications", "operationId": "listNotifications", "parameters": [ { "$ref": "#/components/parameters/Limit" }, { "description": "Gets specific page based on limit.", "in": "query", "name": "page", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "items": { "$ref": "#/components/schemas/Notification" }, "type": "array" }, "limit": { "type": "string" }, "meta": { "properties": { "num_filtered": { "type": "integer" }, "num_read": { "type": "integer" }, "num_unread": { "type": "integer" }, "num_unseen_count": { "type": "integer" }, "types": { "items": { "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "page": { "type": "integer" }, "total": { "type": "integer" } }, "type": "object" } } }, "description": "OK" }, "500": { "$ref": "#/components/responses/InternalServerError" } }, "tags": [ "Notifications" ] }, "post": { "description": "Creates a new notification", "operationId": "createNotification", "requestBody": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/Notification" } }, "required": [ "data" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Notification" } } }, "description": "OK" }, "400": { "$ref": "#/components/responses/BadData" } }, "tags": [ "Notifications" ] } }, "/notifications/mark-all-as-read": { "post": { "description": "Change a notification status", "operationId": "markAllNotificationsRead", "requestBody": { "content": { "application/json": { "schema": { "properties": { "data": { "description": "New status", "properties": { "unread": { "type": "boolean" } }, "type": "object" } }, "type": "object" } } }, "required": true }, "responses": { "200": { "description": "OK" }, "500": { "$ref": "#/components/responses/InternalServerError" } }, "tags": [ "Notifications" ] } }, "/notifications/{id}": { "get": { "description": "Retrieve a specific notification", "operationId": "getNotification", "parameters": [ { "description": "Notification unique identifier", "in": "path", "name": "id", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Notification" } } }, "description": "OK" }, "404": { "$ref": "#/components/responses/NotFound" }, "500": { "$ref": "#/components/responses/InternalServerError" } }, "tags": [ "Notifications" ] }, "patch": { "description": "Updates a specific notification, unread is the only supported field", "operationId": "updateNotification", "parameters": [ { "description": "Notification unique identifier", "in": "path", "name": "id", "required": true, "schema": { "type": "integer" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "data": { "description": "New status", "properties": { "unread": { "type": "boolean" } }, "type": "object" } }, "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Notification" } } }, "description": "OK" }, "404": { "$ref": "#/components/responses/NotFound" }, "500": { "$ref": "#/components/responses/InternalServerError" } }, "tags": [ "Notifications" ] } } } }