Search, index, and manage documents in your Elasticsearch cluster — AI-native full-text search and analytics.
Use with AI AssistantsMCP
Connect Claude, Cursor, or any MCP-compatible client — then call tools directly
① Add This MCP Server
Paste into your AI client config — then all its tools are available instantly.
{
"mcpServers": {
"elasticsearch": {
"url": "https://mcp.aerostack.dev/s/aerostack/mcp-elasticsearch",
"headers": {
"Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
}
}
}
}Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.
② Call a Tool
Ask your AI assistant to call a specific tool, or send raw JSON-RPC:
Natural Language Prompt
“Use the _ping tool to verify elasticsearch connectivity by querying the cluster root. used internally by aerostack to validate credentials”
Using a Workspace?
Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.
Search, index, and manage documents in your Elasticsearch cluster from your AI agents.
Elasticsearch is the distributed search and analytics engine powering search at scale — from full-text search and log analytics to vector similarity and real-time aggregations. This MCP server gives your AI agents direct access to your Elasticsearch cluster: searching documents with the full Query DSL, indexing and updating records, managing indices and mappings, and monitoring cluster health — all through natural language.
Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-elasticsearch
| Tool | Description |
|---|---|
list_indices | List all indices with health, doc count, and size |
get_mapping | Get field mappings for an index |
search | Search documents using Elasticsearch Query DSL |
index_document | Index (create or replace) a document |
get_document | Get a document by ID |
update_document | Partially update a document by ID |
delete_document | Delete a document by ID |
bulk | Bulk index/update/delete operations in one request |
count | Count documents matching an optional query |
create_index | Create an index with optional mappings and settings |
delete_index | Delete an index and all its documents |
cluster_health | Get cluster health status (green/yellow/red) |
| Variable | Required | Description | How to Get |
|---|---|---|---|
ELASTICSEARCH_URL | Yes | Your Elasticsearch cluster URL | Elastic Cloud: Deployments → your deployment → Copy endpoint (e.g. https://my-deploy.es.us-east-1.aws.elastic.cloud:9243). Self-hosted: your cluster's base URL. |
ELASTICSEARCH_API_KEY | Yes | Elasticsearch API key for authentication | Kibana: Stack Management → API Keys → Create API key → copy the Base64-encoded key |
ELASTICSEARCH_URL and ELASTICSEARCH_API_KEY under Project → SecretsOnce added, every AI agent in your workspace can call Elasticsearch tools automatically — no per-user setup needed.
"List all indices in my Elasticsearch cluster and show their doc counts"
"Search the products index for items matching 'wireless headphones' sorted by price ascending"
"Index a new document into the logs index with level: error and message: Connection timeout"
"Get the cluster health and show me any yellow or red indices"
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-elasticsearch \
-H 'Content-Type: application/json' \
-H 'X-Mcp-Secret-ELASTICSEARCH-URL: https://my-deploy.es.us-east-1.aws.elastic.cloud:9243' \
-H 'X-Mcp-Secret-ELASTICSEARCH-API-KEY: your-api-key' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_indices","arguments":{}}}'
MIT
Live Endpoint
https://mcp.aerostack.dev/s/aerostack/mcp-elasticsearch
Sub-50ms globally · Zero cold start
@aerostack
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
by @aerostack
Scrape web pages, crawl entire sites, extract structured data, and search the web — AI-native web data extraction for RAG pipelines.
by @aerostack
Manage Google Ads campaigns, ad groups, keywords, and budgets — automate your PPC advertising with AI.
by @aerostack
Read, write, and format Google Sheets data — use your spreadsheets as a live AI-accessible data source.
by @aerostack
Manage CMS collections, publish content, and control site deployments in Webflow — AI-powered web publishing.
by @aerostack
Create, read, edit, and format Google Docs — paragraph styling, tables, images, comments, and real-time collaboration via Google Docs API.
by @aerostack
Create and manage Google Meet spaces, schedule meetings via Google Calendar, list participants, access recordings and transcripts.
Yes. Claude translates natural language into Elasticsearch DSL and calls the search tool. It can apply filters, sort, paginate results, and summarize hits from any index in the cluster.
Use update_document and delete_document with explicit _id values. Scope the API key to specific indices in Elasticsearch to prevent Claude from touching production indices unintentionally.
Yes. Call cluster_health first; it returns status (green/yellow/red), node count, and shard stats. Claude can abort or warn before issuing bulk operations on a degraded cluster.
Pass an array of index/create/update/delete actions to bulk. Claude can read documents from one index via search, transform them, and write transformed versions to a target index in a single bulk call.