CoreStack

CoreStack AI Agent API

AI Agent Framework API

GitHub OpenAPI

Operations 30

POST /v1/agent/action/confirm Confirm or deny a pending agent action #
POST /v1/agent/chat/batch Batch Chat Details #
POST /v1/agent/chat/conversations/item/{conversation_id} Update the conversation of the chat #
POST /v1/agent/chat/create Create a new chat #
POST /v1/agent/chat/delete Delete the Chat and the conversations associated with it #
GET /v1/agent/chat/item/{chat_id} Get chat details #
POST /v1/agent/chat/item/{chat_id} Update the details of the chat #
GET /v1/agent/chat/item/{chat_id}/suggestions #
POST /v1/agent/chat/list List chats #
POST /v1/agent/conversations/batch Batch conversations Details #
POST /v1/agent/conversations/item/{conversation_id}/interrupt Interrupt the processing conversation of the chat #
GET /v1/agent/conversations/item/{conversation_id}/stream Stream the conversation response for the specified conversation ID #
POST /v1/agent/conversations/list Retrieves the conversations for the specified chat based on the given filter #
POST /v1/agent/feed Submit a new query for the specific agent and retrieve the agent's response for the given feed query #
POST /v1/agent/prompt/batch Retrieve the saved prompt details for the specified ids #
POST /v1/agent/prompt/filters List the filters for the specified agent id and prompt type #
DELETE /v1/agent/prompt/item/{prompt_id} Delete a particular custom prompt #
POST /v1/agent/prompt/list List saved prompts #
POST /v1/agent/prompt/save Saves the prompt #
POST /v1/agent/query Submit a new query for the specified chat and retrieve the agent's response #
POST /v1/agent/report/generate Schedule the generation of a report for Ai agent #
GET /v1/agent/report/item/{report_id} Fetch an Ai agent report by ID #
GET /v1/agent/types List the available agents types #
DELETE /v1/mcp/server/item/{server_id} Delete MCP server #
GET /v1/mcp/server/item/{server_id} Get MCP server details #
PUT /v1/mcp/server/item/{server_id} Update an MCP server's configuration #
PATCH /v1/mcp/server/item/{server_id}/enabled Enable or disable an MCP server post-registration #
POST /v1/mcp/server/list List MCP servers for the current tenant #
POST /v1/mcp/server/register Register a new MCP server for the current tenant #
POST /v1/mcp/server/tools Get MCP tools available for a tenant and business agent #

Documentation

📖
Documentation
https://docs.corestack.io/docs/corestack-api-modules
📖
APIReference
https://docs.corestack.io/reference
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/corestack/refs/heads/main/authentication/corestack-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/corestack/refs/heads/main/openapi/corestack-ai-agent-api-openapi.yml

Other Resources

🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/corestack/refs/heads/main/conventions/corestack-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/corestack/refs/heads/main/errors/corestack-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/corestack/refs/heads/main/data-model/corestack-data-model.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/corestack-ai-agent-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

corestack-ai-agent-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: CoreStack External AI Agent API
  version: 1.0.0
  termsOfService: http://corestack.io/
  license:
    name: CoreStack Inc License
    url: http://corestack.io/licenses/LICENSE-2.0.html
  description: AI Agent Framework API
servers:
- url: /
tags:
- name: AI Agent
  description: AI Agent Framework API
paths:
  /v1/agent/action/confirm:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: string
      summary: Confirm or deny a pending agent action
      description: Confirm or deny a pending agent action. On confirm, the agent executes the action (workload creation, policy execution, etc.). On deny, the action is cancelled with no execution.
      operationId: ConfirmAgentAction
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentActionConfirmRequest'
        required: true
  /v1/agent/chat/batch:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Fetched
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentChatBatchResponse'
      summary: Batch Chat Details
      description: Retrieve the chat details for the specified ids
      operationId: BatchChats
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchRequest'
        required: true
  /v1/agent/chat/conversations/item/{conversation_id}:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: boolean
      summary: Update the conversation of the chat
      description: Update the conversation of the chat.
      operationId: ConversationUpdate
      parameters:
      - name: conversation_id
        in: path
        required: true
        description: Specify the conversation ID to read, ID which can be obtained from the conversations API.
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConversationFeedbackRequest'
        required: true
  /v1/agent/chat/create:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '201':
          description: Created
          content:
            application/json:
              schema:
                type: string
                x-cs-type: ObjectId
      summary: Create a new chat
      description: Create a new Chat
      operationId: CreateChat
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentCreateChatRequest'
        required: true
  /v1/agent/chat/delete:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentChatDeleteResponse'
      summary: Delete the Chat and the conversations associated with it
      description: Delete the chat for the specified ids
      operationId: DeleteChats
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentChatDeleteRequest'
        required: true
  /v1/agent/chat/item/{chat_id}:
    parameters:
    - description: Specify the chat ID to read, ID which can be obtained from the list chats API.
      name: chat_id
      in: path
      required: true
      schema:
        type: string
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Fetched
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentChat'
      summary: Get chat details
      description: Retrieve the current details of the chat.
      operationId: GetChat
      security:
      - auth_token: []
      tags:
      - AI Agent
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '412':
          description: Validation Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationResults'
        '200':
          description: Fetched
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentChat'
      summary: Update the details of the chat
      description: Update the details of the chat.
      operationId: UpdateChatName
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentChatUpdateRequest'
        required: true
  /v1/agent/chat/item/{chat_id}/suggestions:
    parameters:
    - name: chat_id
      in: path
      required: true
      schema:
        type: string
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentPromptSuggestionResponse'
      description: Get the chat suggestions
      operationId: ListChatSuggestions
      security:
      - auth_token: []
      tags:
      - AI Agent
  /v1/agent/chat/list:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Fetched
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentListChatResponse'
      summary: List chats
      description: Retrieve the ids of chats matching the filtering criteria
      operationId: ListChats
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentListChatRequest'
        required: true
  /v1/agent/conversations/batch:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Fetched
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChatConversationBatchResponse'
      summary: Batch conversations Details
      description: Retrieve the conversations details for the specified ids
      operationId: BatchConversations
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchRequest'
        required: true
  /v1/agent/conversations/item/{conversation_id}/interrupt:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: boolean
      summary: Interrupt the processing conversation of the chat
      description: Interrupt the processing conversation of the chat.
      operationId: InterruptConversation
      parameters:
      - name: conversation_id
        in: path
        required: true
        description: Specify the conversation ID to read, ID which can be obtained from the conversations API.
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - AI Agent
  /v1/agent/conversations/item/{conversation_id}/stream:
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success - Streaming data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentStreamingResponse'
      summary: Stream the conversation response for the specified conversation ID
      description: 'Stream the conversation response for the specified conversation ID using Server-Sent Events (SSE).

        Returns an SSE stream with real-time data chunks.'
      operationId: StreamQueryResponse
      parameters:
      - name: conversation_id
        in: path
        required: true
        description: Specify the conversation ID to read, ID which can be obtained from the conversations API.
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - AI Agent
  /v1/agent/conversations/list:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChatConversationListResponse'
      summary: Retrieves the conversations for the specified chat based on the given filter
      description: Fetch the conversations for the specified chat based on the given filter.
      operationId: ListConversations
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChatConversationRequest'
        required: true
  /v1/agent/feed:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserQueryResponse'
      summary: Submit a new query for the specific agent and retrieve the agent's response for the given feed query
      description: Submit a new query for the specific agent and retrieve the agent's response for the given feed query.
      operationId: AgenticFeed
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserQueryRequest'
        required: true
  /v1/agent/prompt/batch:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Fetched
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PromptBatchResponse'
      summary: Retrieve the saved prompt details for the specified ids
      description: Retrieve the saved prompt details for the specified ids
      operationId: BatchSavedPrompts
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchRequest'
        required: true
  /v1/agent/prompt/filters:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Fetched
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PromptFiltersResponse'
      summary: List the filters for the specified agent id and prompt type
      description: Retrieve the filters for the specified agent id and prompt type.
      operationId: ListPromptFilters
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PromptFiltersRequest'
        required: true
  /v1/agent/prompt/item/{prompt_id}:
    parameters:
    - description: Specify the prompt ID to read, ID which can be obtained from the list prompts API.
      name: prompt_id
      in: path
      required: true
      schema:
        type: string
    delete:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Deleted
          content:
            application/json:
              schema:
                type: boolean
      summary: Delete a particular custom prompt
      description: Delete the custom prompt.
      operationId: DeletePrompt
      security:
      - auth_token: []
      tags:
      - AI Agent
  /v1/agent/prompt/list:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Fetched
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PromptListResponse'
      summary: List saved prompts
      description: Retrieve the ids of saved prompts matching the filtering criteria
      operationId: ListSavedPrompts
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PromptListRequest'
        required: true
  /v1/agent/prompt/save:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '201':
          description: Created
          content:
            application/json:
              schema:
                type: string
                x-cs-type: ObjectId
      summary: Saves the prompt
      description: Saves the prompt.
      operationId: SavePrompt
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PromptSaveRequest'
        required: true
  /v1/agent/query:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: string
                x-cs-type: ObjectId
      summary: Submit a new query for the specified chat and retrieve the agent's response
      description: Submit a new query for the specified chat and retrieve the agent's response.
      operationId: SubmitNewQuery
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserQueryRequest'
        required: true
  /v1/agent/report/generate:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Fetched
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordIdentity'
      summary: Schedule the generation of a report for Ai agent
      description: Generate a report for an Ai agent
      operationId: report-create
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AiAgentReportCreateRequest'
        required: true
  /v1/agent/report/item/{report_id}:
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Fetched
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AiAgentReport'
      summary: Fetch an Ai agent report by ID
      description: Get a report for an agent.
      operationId: report-get
      parameters:
      - name: report_id
        in: path
        required: true
        description: ID of the report to fetch. This can be retrieved using Report Generation API.
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - AI Agent
  /v1/agent/types:
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentTypeResponse'
      summary: List the available agents types
      description: List of Agent types.
      operationId: AgentTypes
      security:
      - auth_token: []
      tags:
      - AI Agent
  /v1/mcp/server/item/{server_id}:
    parameters:
    - description: MCP server ID returned from the register API.
      name: server_id
      in: path
      required: true
      schema:
        type: string
    delete:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Deleted
      summary: Delete MCP server
      description: Delete a registered MCP server.
      operationId: DeleteMcpServer
      security:
      - auth_token: []
      tags:
      - AI Agent
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpServerItem'
      summary: Get MCP server details
      description: Retrieve details of a specific MCP server.
      operationId: GetMcpServer
      security:
      - auth_token: []
      tags:
      - AI Agent
    put:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Updated
      summary: Update an MCP server's configuration
      description: Update a registered MCP server.
      operationId: UpdateMcpServer
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/McpServerRequest'
        required: true
  /v1/mcp/server/item/{server_id}/enabled:
    parameters:
    - description: MCP server ID returned from the register API.
      name: server_id
      in: path
      required: true
      schema:
        type: string
    patch:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Success
      summary: Enable or disable an MCP server post-registration
      description: Enable or disable a registered MCP server without modifying its configuration.
      operationId: SetMcpServerEnabled
      security:
      - auth_token: []
      tags:
      - AI Agent
      requestBody:
        content:
          application/json:
            schema:
              $ref: '

# --- truncated at 32 KB (59 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/corestack/refs/heads/main/openapi/corestack-ai-agent-api-openapi.yml