Elasticsearch

​

Run the MCP Elasticsearch Agent and Toolkit in the Cloud

Required Environment Variables:

• ES_URL: URL of your Elasticsearch instance (e.g., http://localhost:9200)
• ES_API_KEY: Your Elasticsearch API key (e.g., your-api-key)

​

Steps

1. Install Meshagent CLI and Toolkits

   Copy

   Ask AI

   pip install "meshagent[all]"
   

2. Sign Up and Authenticate

   • Follow the steps at Meshagent CLI: Get Started to sign up and authenticate.

3. Start the MCP Elasticsearch Server as a Meshagent Service

   Copy

   Ask AI

   meshagent service test \
     --room=test \
     --role=agent \
     --image=meshagent/mcp-elasticsearch:latest \
     --env MESHAGENT_PORT=8001 \
     --env ES_URL=<your-es-url> \
     --env ES_API_KEY=<your-es-api-key> \
     --port="num=8001 path=/webhook liveness=/ type=meshagent.callable" \
     --name=mcp-elasticsearch-service
   

   • This command starts a Meshagent room with the MCP Elasticsearch server available. Rooms will automatically close if they become inactive.

4. Join the Room with a Chatbot Agent Using the Elasticsearch Toolkit

   Copy

   Ask AI

   meshagent chatbot join \
     --room=test \
     --agent-name=sample \
     --name=sample \
     --toolkit=mcp-elasticsearch
   

   • This starts a chatbot in the Meshagent room enabled with the Elasticsearch toolkit. Multiple toolkits can be used in the same room with the same agent.
   • A link to the room will be provided in the output of this command, where you can interact with the agent and tools.

​

Tools Available

Interact with your Elasticsearch indices through natural language conversations.

What is an MCP Server?

​

Tools Summary

​

Tools Details

​

get_mappings

Get field mappings for a specific Elasticsearch index.

​

get_shards

Get shard information for all or specific indices.

​

list_indices

List all available Elasticsearch indices.

​

search

Perform an Elasticsearch search with the provided query DSL. Highlights are always enabled.

​

Meshagent & MCP Resources

• Meshagent: https://www.meshagent.com/
• Getting Started: Room API Quickstart
• Room API Overview: Overview
• Meshagent MCP Tool Image: meshagent/mcp-elasticsearch on Docker Hub