Updates the schema definition of the context

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://openapi.docs.brease.run/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "brease MCP server": {
    "url": "https://openapi.docs.brease.run/mcp"
  }
}

Close
POST /v1/{contextId}/schema

Updates the schema definition of the context

Path parameters

  • contextId string Required
application/json

Body Required

  • contextId string
  • schema string

Responses

  • 200 application/json

    OK

  • default application/json

    Default error response

    Hide response attributes Show response attributes object
    • code integer(int32)

      The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

    • message string

      A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.

    • details array[object]

      A list of messages that carry the error details. There is a common set of message types for APIs to use.

      Hide details attribute Show details attribute object

      Contains an arbitrary serialized message along with a @type that describes the type of the serialized message.

      • @type string

        The type of the serialized message.

POST /v1/{contextId}/schema
curl \
 --request POST 'https://api.brease.run/v1/{contextId}/schema' \
 --header "Content-Type: application/json" \
 --data '{"contextId":"string","schema":"string"}'
Request examples
{
  "contextId": "string",
  "schema": "string"
}
Response examples (200)
{}
Response examples (default)
{
  "code": 42,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}