MCP server Technical Preview

POST /api/agent_builder/mcp
Api key auth

Communicate with the MCP server via JSON-RPC 2.0. MCP is designed for AI clients like Claude Desktop, Cursor, and VS Code extensions to access your Elastic tools. Use this endpoint for testing MCP connectivity or debugging protocol communication. This endpoint requires JSON-RPC formatting and will not work from the Dev Tools Console.

[Required authorization] Route required privileges: read_onechat.

application/json

Body

Responses

  • 200 application/json

    Indicates a successful response

POST /api/agent_builder/mcp 
curl \
 --request POST 'https://<KIBANA_URL>/api/agent_builder/mcp' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{"id":1,"method":"initialize","params":{"clientInfo":{"name":"test-client","version":"1.0.0"},"capabilities":{},"protocolVersion":"2024-11-05"},"jsonrpc":"2.0"}'
Request example
Example request to initalise communication over MCP protocol 
{
  "id": 1,
  "method": "initialize",
  "params": {
    "clientInfo": {
      "name": "test-client",
      "version": "1.0.0"
    },
    "capabilities": {},
    "protocolVersion": "2024-11-05"
  },
  "jsonrpc": "2.0"
}
Response examples (200)
Example response showing the successful result of communication initialisation over MCP protocol 
{
  "id": 1,
  "result": {
    "serverInfo": {
      "name": "elastic-mcp-server",
      "version": "0.0.1"
    },
    "capabilities": {
      "tools": {
        "listChanged": true
      }
    },
    "protocolVersion": "2024-11-05"
  },
  "jsonrpc": "2.0"
}