MCP Portal Servers

Create a new MCP Server

POST /accounts/{account_id}/access/ai-controls/mcp/servers

Responses

201 Returns the created Object

Data is at body["result"]

{
  "auth_type": "*string*",
  "created_at": "*string*",
  "created_by": "*string*",
  "description": "*string*",
  "error": "*string*",
  "hostname": "*string*",
  "id": "*string*",
  "last_successful_sync": "*string*",
  "last_synced": "*string*",
  "modified_at": "*string*",
  "modified_by": "*string*",
  "name": "*string*",
  "prompts": [
    {}
  ],
  "status": "*string*",
  "tools": [
    {}
  ]
}

400 Input Validation Error

{
  "errors": [
    {
      "code": "*number*",
      "message": "*string*",
      "path": [
        "*string*"
      ]
    }
  ],
  "success": "*boolean*"
}

List MCP Servers

GET /accounts/{account_id}/access/ai-controls/mcp/servers

Responses

200 List objects

Data is at body["result"]

[
  {
    "auth_type": "*string*",
    "created_at": "*string*",
    "created_by": "*string*",
    "description": "*string*",
    "error": "*string*",
    "hostname": "*string*",
    "id": "*string*",
    "last_successful_sync": "*string*",
    "last_synced": "*string*",
    "modified_at": "*string*",
    "modified_by": "*string*",
    "name": "*string*",
    "prompts": [
      {}
    ],
    "status": "*string*",
    "tools": [
      {}
    ]
  }
]

400 Bad Request

{
  "errors": [
    {
      "message": "*string*"
    }
  ],
  "result": {},
  "success": "*boolean*"
}

Update a MCP Server

PUT /accounts/{account_id}/access/ai-controls/mcp/servers/{id}

Responses

200 Returns the updated Object

Data is at body["result"]

{
  "auth_type": "*string*",
  "created_at": "*string*",
  "created_by": "*string*",
  "description": "*string*",
  "error": "*string*",
  "hostname": "*string*",
  "id": "*string*",
  "last_successful_sync": "*string*",
  "last_synced": "*string*",
  "modified_at": "*string*",
  "modified_by": "*string*",
  "name": "*string*",
  "prompts": [
    {}
  ],
  "status": "*string*",
  "tools": [
    {}
  ]
}

400 Input Validation Error

{
  "errors": [
    {
      "code": "*number*",
      "message": "*string*",
      "path": [
        "*string*"
      ]
    }
  ],
  "success": "*boolean*"
}

404 Not Found

{
  "errors": [
    {
      "code": "*number*",
      "message": "*string*"
    }
  ],
  "success": "*boolean*"
}

Read the details of a MCP Server

GET /accounts/{account_id}/access/ai-controls/mcp/servers/{id}

Responses

200 Returns a single object if found

Data is at body["result"]

{
  "auth_type": "*string*",
  "created_at": "*string*",
  "created_by": "*string*",
  "description": "*string*",
  "error": "*string*",
  "hostname": "*string*",
  "id": "*string*",
  "last_successful_sync": "*string*",
  "last_synced": "*string*",
  "modified_at": "*string*",
  "modified_by": "*string*",
  "name": "*string*",
  "prompts": [
    {}
  ],
  "status": "*string*",
  "tools": [
    {}
  ]
}

404 Not Found

{
  "errors": [
    {
      "code": "*number*",
      "message": "*string*"
    }
  ],
  "success": "*boolean*"
}

Delete a MCP Server

DELETE /accounts/{account_id}/access/ai-controls/mcp/servers/{id}

Responses

200 Returns the Object if it was successfully deleted

Data is at body["result"]

{
  "auth_type": "*string*",
  "created_at": "*string*",
  "created_by": "*string*",
  "description": "*string*",
  "error": "*string*",
  "hostname": "*string*",
  "id": "*string*",
  "last_successful_sync": "*string*",
  "last_synced": "*string*",
  "modified_at": "*string*",
  "modified_by": "*string*",
  "name": "*string*",
  "prompts": [
    {}
  ],
  "status": "*string*",
  "tools": [
    {}
  ]
}

404 Not Found

{
  "errors": [
    {
      "code": "*number*",
      "message": "*string*"
    }
  ],
  "success": "*boolean*"
}

Sync MCP Server Capabilities

POST /accounts/{account_id}/access/ai-controls/mcp/servers/{id}/sync

Responses

200

Data is at body["result"]

{}

404 Not Found

{
  "errors": [
    {
      "code": "*number*",
      "message": "*string*"
    }
  ],
  "success": "*boolean*"
}