Storm MCP

Storm MCP App Instructions API

The AppInstructions API from Storm MCP — 2 operation(s) for appinstructions.

GitHub OpenAPI

Operations 4

GET /api/v1/admin/AppInstructions Gets the servers that have app instructions configured for the current tenant. #
GET /api/v1/admin/AppInstructions/{serverId} Gets the app instructions configured for a single server #
PUT /api/v1/admin/AppInstructions/{serverId} Creates or replaces the app instructions for a server. #
DELETE /api/v1/admin/AppInstructions/{serverId} Removes the app instructions for a server #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/stormmcp/refs/heads/main/openapi/stormmcp-appinstructions-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/stormmcp/refs/heads/main/json-schema/stormmcp-oidcclient-representation-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/stormmcp/refs/heads/main/json-schema/stormmcp-gateway-configuration-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/stormmcp/refs/heads/main/json-schema/stormmcp-known-mcp-server-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/stormmcp/refs/heads/main/json-schema/stormmcp-gateway-configuration-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/stormmcp/refs/heads/main/json-schema/stormmcp-known-mcp-server-with-status-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/stormmcp/refs/heads/main/json-schema/stormmcp-library-catalog-invalidation-result-schema.json

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/stormmcp:stormmcp-appinstructions-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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

stormmcp-appinstructions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: MCP Gateway App Instructions API
  description: API for MCP Gateway operations
  version: v1
servers:
- url: https://dev.stormmcp.ai/
tags:
- name: AppInstructions
paths:
  /api/v1/admin/AppInstructions:
    get:
      tags:
      - AppInstructions
      summary: Gets the servers that have app instructions configured for the current tenant.
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ConfiguredAppInstructionsResponse'
            application/json:
              schema:
                $ref: '#/components/schemas/ConfiguredAppInstructionsResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/ConfiguredAppInstructionsResponse'
            text/csv:
              schema:
                $ref: '#/components/schemas/ConfiguredAppInstructionsResponse'
            application/csv:
              schema:
                $ref: '#/components/schemas/ConfiguredAppInstructionsResponse'
        '401':
          description: Unauthorized
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      operationId: getApiV1AdminAppInstructions
      x-operation-id-source: derived
  /api/v1/admin/AppInstructions/{serverId}:
    get:
      tags:
      - AppInstructions
      summary: Gets the app instructions configured for a single server
      parameters:
      - name: serverId
        in: path
        description: The unified server identifier.
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/AppInstructionResponse'
            application/json:
              schema:
                $ref: '#/components/schemas/AppInstructionResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/AppInstructionResponse'
            text/csv:
              schema:
                $ref: '#/components/schemas/AppInstructionResponse'
            application/csv:
              schema:
                $ref: '#/components/schemas/AppInstructionResponse'
        '401':
          description: Unauthorized
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Not Found
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      operationId: getApiV1AdminAppInstructionsByServerId
      x-operation-id-source: derived
    put:
      tags:
      - AppInstructions
      summary: Creates or replaces the app instructions for a server.
      description: 'The `400` is produced by MVC''s automatic model-state filter, which `[ApiController]`

        runs before this action and the host does not suppress — so a blank `Instructions` or an

        over-length description is answered with `ValidationProblemDetails` and its field-level

        `errors` dictionary, which is more useful to a form than a single error code would be. Do

        not add a `ModelState.IsValid` check here; it can never be false.'
      parameters:
      - name: serverId
        in: path
        description: The unified server identifier.
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        description: The cancellation token.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SaveAppInstructionRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/SaveAppInstructionRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/SaveAppInstructionRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/AppInstructionResponse'
            application/json:
              schema:
                $ref: '#/components/schemas/AppInstructionResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/AppInstructionResponse'
            text/csv:
              schema:
                $ref: '#/components/schemas/AppInstructionResponse'
            application/csv:
              schema:
                $ref: '#/components/schemas/AppInstructionResponse'
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Not Found
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      operationId: putApiV1AdminAppInstructionsByServerId
      x-operation-id-source: derived
    delete:
      tags:
      - AppInstructions
      summary: Removes the app instructions for a server
      parameters:
      - name: serverId
        in: path
        description: The unified server identifier.
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '204':
          description: No Content
        '401':
          description: Unauthorized
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Not Found
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/csv:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      operationId: deleteApiV1AdminAppInstructionsByServerId
      x-operation-id-source: derived
components:
  schemas:
    ProblemDetails:
      type: object
      properties:
        type:
          type:
          - 'null'
          - string
        title:
          type:
          - 'null'
          - string
        status:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
          - 'null'
          - integer
          - string
          format: int32
        detail:
          type:
          - 'null'
          - string
        instance:
          type:
          - 'null'
          - string
    AppInstructionResponse:
      type: object
      properties:
        serverId:
          type: string
          description: Gets or sets the unified server identifier these instructions belong to.
          format: uuid
        serverName:
          type: string
          description: 'Gets or sets the display name of the server, resolved from the catalog or the tenant''s

            custom servers. Included so the admin UI can title the page without a second lookup.'
        instructions:
          type: string
          description: Gets or sets the markdown guidance returned by the synthesized instructions tool.
        instructionsToolDescription:
          type:
          - 'null'
          - string
          description: 'Gets or sets the description advertised to LLMs for this app''s instructions tool.

            Null means the generated default naming the app is used.'
        toolName:
          type: string
          description: 'Gets or sets the name of the native tool this configuration synthesizes, for example

            `jira__get_app_instructions`. Advisory only — the effective name is allocated per

            session so it can be disambiguated against other apps and deployments present there.'
        createdAt:
          type: string
          description: Gets or sets the creation timestamp.
          format: date-time
        updatedAt:
          type: string
          description: Gets or sets the last update timestamp.
          format: date-time
      description: The tenant-wide instructions configured for a single MCP server (MCPG-1296).
    ConfiguredAppInstructionsResponse:
      type: object
      properties:
        serverIds:
          type: array
          items:
            type: string
            format: uuid
          description: 'Gets or sets the server identifiers that have app instructions configured for this tenant.

            A server absent from this list shows "Configure"; a server present shows "Edit".'
      description: 'The batched existence check backing the Server Management grid''s Configure/Edit indicator

        (MCPG-1296): one call resolves the state of every visible row, rather than one call per row.'
    SaveAppInstructionRequest:
      required:
      - instructions
      type: object
      properties:
        instructions:
          type: string
          description: "    Gets or sets the markdown guidance returned by the synthesized instructions tool.\n    Deliberately uncapped: MCPG-1296 requires bodies longer than 8,192 characters to round-trip\nwithout validation failure or truncation. Content is still required — clearing instructions\nis an explicit DELETE, not an empty save, so the two intents stay distinguishable."
        instructionsToolDescription:
          maxLength: 500
          type:
          - 'null'
          - string
          description: "    Gets or sets the description advertised to LLMs for this app's instructions tool.\n    An explicit null clears any stored description and restores the generated default\nnaming the app; the field is always applied on save, so an omitted value is treated as\nnull rather than \"leave unchanged\"."
      description: Request body for creating or replacing a server's tenant-wide app instructions (MCPG-1296).