POST /mcp-servers/{mcp_server_id_or_slug}/deploy
Authorization token

Deploy a new workflow document for a given MCP server.

Learn more about MCP servers

Path parameters

  • mcp_server_id_or_slug string Required

    UUID or slug of a MCP server

application/json

Body

  • definition string Required

    Workflow definition of the MCP server.

  • references array[object]

    List of external references required for Arazzo workflow documents (aka API sources definitions following the OpenAPI specification). More details about Arazzo and sourcesDescriptions in the Arazzo documentation.

    Hide references attributes Show references attributes object
    • name string
    • content string
    • location string

Responses

  • 201 application/json

    MCP server workflow document successfully deployed

    Hide response attributes Show response attributes object
    • id string

      UUID of the workflow deployment

    • mcp_server_id string

      UUID of the MCP server
  • 204

    MCP server workflow document already exists

  • 422 application/json

    Invalid MCP server deployment request

    Hide response attributes Show response attributes object
    • message string

      Human readable error message.

    • errors object

      Hash of invalid attributes with their error messages.
POST /mcp-servers/{mcp_server_id_or_slug}/deploy 
curl \
 --request POST 'https://bump.sh/api/v1/mcp-servers/holiday-booking/deploy' \
 --header "Authorization: Token $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"definition":"{\"flower\": \"0.1\", \"title\": \"About crabs\"}\n","references":[{"name":"firstSource","content":"{openapi: 3.0.0, title: My first Source}","location":"./openapi/first-source.yml"}]}'
Request examples 
{
  "definition": "{\"flower\": \"0.1\", \"title\": \"About crabs\"}\n",
  "references": [
    {
      "name": "firstSource",
      "content": "{openapi: 3.0.0, title: My first Source}",
      "location": "./openapi/first-source.yml"
    }
  ]
}
Response examples (201) 
{
  "id": "string",
  "mcp_server_id": "string"
}
Response examples (422) 
{
  "message": "Invalid definition file",
  "errors": {
    "raw_definition": [
      "The property '#/paths//docs/{:id}/validations/post' contains additional properties [\"yolo\"] outside of the schema when none are allowed"
    ]
  }
}