Elastic Agent Builder MCP Server logo

Elastic Agent Builder MCP Server

Connects MCP clients to Kibana Agent Builder tools for Elasticsearch search and ES|QL queries.

Install Elastic Agent Builder MCP Server

Run the project’s own setup commands, in order.

Setup steps from the project

Elastic Agent Builder MCP Server installs with its own commands rather than a config we can generate, so these are copied as-is from its maintainers’ setup guide. Run them in order in a terminal. Source: elastic.co

MCP_SERVER_URL is {KIBANA_URL}/api/agent_builder/mcp (or /s/{SPACE_ID}/api/agent_builder/mcp). Needs Elastic 9.2+ or a Serverless project.

  1. 1. Add to Claude Code
    claude mcp add --transport http --client-id {CLIENT_ID} kibana-mcp {MCP_SERVER_URL}
    

Overview

Elastic Agent Builder MCP Server is built into Kibana's Agent Builder and exposes Agent Builder tools to MCP clients. It provides access to Elasticsearch search and ES|QL queries through the `{KIBANA_URL}/api/agent_builder/mcp` endpoint. Authentication supports an API key or OAuth access. Use it when an agent needs to query Elastic data through Agent Builder on Elastic 9.2 or later, or on Elasticsearch Serverless.

Use cases

  • Search Elasticsearch indexes from an MCP-compatible agent
  • Run ES|QL queries through Kibana Agent Builder
  • Expose configured Agent Builder tools to an MCP client
  • Migrate from the deprecated Elasticsearch MCP server

Key features

  • Kibana-hosted MCP endpoint
  • Elasticsearch search tools
  • ES|QL query support
  • API key authentication
  • OAuth authentication
  • Elastic 9.2+ and Elasticsearch Serverless support

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

How Elastic Agent Builder MCP Server works

What Elastic Agent Builder MCP Server does

Elastic Agent Builder MCP Server exposes tools configured in Kibana's Agent Builder through the Model Context Protocol. Its documented capabilities include Elasticsearch search and ES|QL query access, allowing compatible MCP clients to use Elastic data tools from an agent workflow.

The server is part of Kibana rather than a separate Elasticsearch MCP process. It is available with Elastic 9.2 and later and with Elasticsearch Serverless. The service replaces the deprecated elastic/mcp-server-elasticsearch server.

How it works

MCP clients connect to the Agent Builder endpoint hosted by Kibana:

text
{KIBANA_URL}/api/agent_builder/mcp

Replace {KIBANA_URL} with the URL of the Kibana instance that contains the Agent Builder configuration. Once connected, the client can access the Agent Builder tools exposed through that instance, including Elasticsearch search and ES|QL query tools.

Access is authorized with either an API key or OAuth. The connection therefore uses the security and access controls associated with the Kibana deployment rather than a standalone local process.

Setup and configuration

Use an Elastic deployment that provides Kibana Agent Builder on Elastic 9.2 or later, or use Elasticsearch Serverless. In the MCP client, configure a connection to the Kibana URL followed by /api/agent_builder/mcp.

Provide authentication using one of the supported methods:

  • An Elastic API key
  • OAuth access

The endpoint is hosted by Kibana, so the client must be able to reach that Kibana URL and the credentials must grant the access required by the Agent Builder tools being used.

Tools and capabilities

The exposed tool set is based on the tools available through Kibana's Agent Builder. Supported data operations include:

  • Searching Elasticsearch data
  • Running ES|QL queries
  • Making Agent Builder tools available to MCP-compatible clients

The server is suited to agents that need Elastic search and query functionality without using the deprecated standalone Elasticsearch MCP server.

Limitations and notes

Availability depends on the Elastic platform and version: use Elastic 9.2 or later or Elasticsearch Serverless with Agent Builder. The endpoint exposes Agent Builder tools rather than an independently defined tool catalog. Access also depends on valid API-key or OAuth authorization and connectivity to the Kibana host.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Elastic Agent Builder MCP Server

Elastic Agent Builder MCP Server is an MCP server that connects MCP clients to Kibana's Agent Builder and exposes Agent Builder tools such as Elasticsearch search and ES|QL queries. It authenticates with an API key or OAuth and serves requests through Kibana's MCP endpoint.

You do not install it as a separate server process; it is built into Kibana's Agent Builder. Use Elastic 9.2 or later or Elasticsearch Serverless, then connect an MCP client to `{KIBANA_URL}/api/agent_builder/mcp`.

Connect the client to `{KIBANA_URL}/api/agent_builder/mcp` and authenticate with an API key or OAuth access. The Kibana deployment must provide Agent Builder and be reachable by the client.

Yes. It exposes Agent Builder tools that include Elasticsearch search and ES|QL queries through the Kibana-hosted MCP endpoint.

No. Elastic Agent Builder MCP Server replaces the deprecated `elastic/mcp-server-elasticsearch` server for this Agent Builder-based MCP integration.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewElastic Agent Builder MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/elastic-agent-builder-mcp?style=directory)](https://allmcps.com/mcp/elastic-agent-builder-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/elastic-agent-builder-mcp"><img src="https://allmcps.com/api/badge/elastic-agent-builder-mcp?style=directory" alt="Elastic Agent Builder MCP Server on AllMCPs" /></a>