Elasticsearch

Elasticsearch MCP Server for Cloudflare Workers

Available Tools

54 tools available in the Elasticsearch MCP server. Each tool can be called by AI assistants to perform specific actions.

elasticsearch_get_index_template

Get index templates.

Args:

name: Optional template name or pattern

Returns: Index template definitions.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Template name or pattern"
    }
  }
}

elasticsearch_get_aliases

Get index aliases.

Args:

index: Optional index name(s) to get aliases for
alias: Optional alias name(s) to get
format: Response format

Returns: Alias information for matching indices.

{
  "type": "object",
  "properties": {
    "alias": {
      "type": "string",
      "description": "Alias name(s)"
    },
    "index": {
      "type": "string",
      "description": "Index name(s)"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

elasticsearch_update_aliases

Atomically add, remove, or update index aliases.

Args:

actions: Array of alias actions to perform atomically Each action is one of:
- { "add": { "index": "...", "alias": "...", "filter": {...}, "is_write_index": true/false } }
- { "remove": { "index": "...", "alias": "..." } }
- { "remove_index": { "index": "..." } }

Example: [ { "add": { "index": "logs-2024-01", "alias": "logs-current" } }, { "remove": { "index": "logs-2023-12", "alias": "logs-current" } } ]

Returns: Acknowledgment of the update.

{
  "type": "object",
  "required": [
    "actions"
  ],
  "properties": {
    "actions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Alias actions to perform"
    }
  }
}

elasticsearch_add_alias

Add an alias to an index.

Args:

index: Index name(s) to add alias to
alias: Alias name
filter: Optional filter query for the alias
routing: Optional routing value
is_write_index: Whether this is the write index for the alias

Returns: Acknowledgment.

{
  "type": "object",
  "required": [
    "index",
    "alias"
  ],
  "properties": {
    "alias": {
      "type": "string",
      "description": "Alias name"
    },
    "index": {
      "type": "string",
      "description": "Index name(s)"
    },
    "filter": {
      "type": "object",
      "description": "Filter query"
    },
    "routing": {
      "type": "string",
      "description": "Routing value"
    },
    "is_write_index": {
      "type": "boolean",
      "description": "Set as write index"
    }
  }
}

elasticsearch_remove_alias

Remove an alias from an index.

Args:

index: Index name(s)
alias: Alias name to remove

Returns: Acknowledgment.

{
  "type": "object",
  "required": [
    "index",
    "alias"
  ],
  "properties": {
    "alias": {
      "type": "string",
      "description": "Alias name"
    },
    "index": {
      "type": "string",
      "description": "Index name(s)"
    }
  }
}

elasticsearch_alias_exists

Check if an alias exists for an index.

Args:

index: Index name
alias: Alias name

Returns: Boolean indicating whether the alias exists.

{
  "type": "object",
  "required": [
    "index",
    "alias"
  ],
  "properties": {
    "alias": {
      "type": "string",
      "description": "Alias name"
    },
    "index": {
      "type": "string",
      "description": "Index name"
    }
  }
}

elasticsearch_cat_indices

List all indices with their health, status, document count, and size.

Args:

index: Optional index name or pattern to filter
health: Filter by health status ('green', 'yellow', 'red')
format: Response format ('json' or 'markdown')

Returns: List of indices with details.

{
  "type": "object",
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name or pattern"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "health": {
      "enum": [
        "green",
        "yellow",
        "red"
      ],
      "type": "string",
      "description": "Filter by health"
    }
  }
}

elasticsearch_cat_nodes

List all nodes in the cluster with resource usage.

Returns: List of nodes with IP, heap, RAM, CPU, load, and role information.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

elasticsearch_cat_shards

List all shards with their state and node assignment.

Args:

index: Optional index name to filter
format: Response format

Returns: List of shards with index, shard number, type, state, docs, and node.

{
  "type": "object",
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

elasticsearch_cat_aliases

List all aliases.

Args:

alias: Optional alias name or pattern to filter
format: Response format

Returns: List of aliases with their target indices and configuration.

{
  "type": "object",
  "properties": {
    "alias": {
      "type": "string",
      "description": "Alias name or pattern"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

elasticsearch_cat_health

Get cluster health in a compact format.

Returns: Cluster health status with node and shard counts.

{
  "type": "object",
  "properties": {}
}

elasticsearch_cat_count

Get document count for indices.

Args:

index: Optional index name to count documents for

Returns: Document count.

{
  "type": "object",
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name"
    }
  }
}

elasticsearch_mget

Get multiple documents by ID from Elasticsearch.

Args:

docs: Array of document identifiers with _index and _id
index: Default index (optional, can be specified per doc)

Returns: Array of documents with their sources.

{
  "type": "object",
  "properties": {
    "index": {
      "type": "string",
      "description": "Default index"
    }
  }
}

elasticsearch_cluster_health

Get the health status of the Elasticsearch cluster.

Args:

index: Optional index(es) to limit health check to
level: Detail level ('cluster', 'indices', or 'shards')
wait_for_status: Wait until cluster reaches this status ('green', 'yellow', 'red')
timeout: How long to wait for the status (e.g., "30s")
format: Response format ('json' or 'markdown')

Returns: Cluster health information including status, nodes, and shards.

{
  "type": "object",
  "properties": {
    "index": {
      "type": "string",
      "description": "Index(es) to check"
    },
    "level": {
      "enum": [
        "cluster",
        "indices",
        "shards"
      ],
      "type": "string",
      "description": "Detail level"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "timeout": {
      "type": "string",
      "description": "Wait timeout"
    },
    "wait_for_status": {
      "enum": [
        "green",
        "yellow",
        "red"
      ],
      "type": "string",
      "description": "Wait for status"
    }
  }
}

elasticsearch_cluster_stats

Get comprehensive cluster statistics.

Returns information about:

Indices: count, docs, store size
Nodes: count by role, versions, OS, JVM
Memory and disk usage

Returns: Cluster statistics.

{
  "type": "object",
  "properties": {}
}

elasticsearch_nodes_info

Get information about cluster nodes.

Args:

node_id: Optional node ID(s) to get info for (all nodes if not specified)

Returns: Node information including version, roles, OS, JVM, and plugins.

{
  "type": "object",
  "properties": {
    "node_id": {
      "type": "string",
      "description": "Node ID(s)"
    }
  }
}

elasticsearch_nodes_stats

Get statistics for cluster nodes.

Args:

node_id: Optional node ID(s) to get stats for

Returns: Node statistics including CPU, memory, disk, indexing, and search metrics.

{
  "type": "object",
  "properties": {
    "node_id": {
      "type": "string",
      "description": "Node ID(s)"
    }
  }
}

elasticsearch_allocation_explain

Explain why a shard is unassigned or allocated to its current node.

Args:

index: Optional index name
shard: Optional shard number
primary: Optional boolean to specify primary/replica

If no args provided, explains the first unassigned shard found.

Returns: Explanation of shard allocation decisions.

{
  "type": "object",
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name"
    },
    "shard": {
      "type": "integer",
      "description": "Shard number"
    },
    "primary": {
      "type": "boolean",
      "description": "Primary shard"
    }
  }
}

elasticsearch_index_document

Index (create or update) a document in Elasticsearch.

Args:

index: The index name
document: The document to index (JSON object)
id: Optional document ID (auto-generated if not provided)
refresh: Whether to refresh the index after indexing ('true', 'false', or 'wait_for')
pipeline: Optional ingest pipeline to run

Returns: Index response with document ID, version, and result.

{
  "type": "object",
  "required": [
    "index",
    "document"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Document ID (optional, auto-generated if not provided)"
    },
    "index": {
      "type": "string",
      "description": "Index name"
    },
    "refresh": {
      "enum": [
        "true",
        "false",
        "wait_for"
      ],
      "type": "string",
      "description": "Refresh policy"
    },
    "document": {
      "type": "object",
      "description": "Document to index"
    },
    "pipeline": {
      "type": "string",
      "description": "Ingest pipeline name"
    }
  }
}

elasticsearch_get_document

Get a document by ID from Elasticsearch.

Args:

index: The index name
id: The document ID
source_includes: Optional array of fields to include
source_excludes: Optional array of fields to exclude

Returns: The document with metadata and source.

{
  "type": "object",
  "required": [
    "index",
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Document ID"
    },
    "index": {
      "type": "string",
      "description": "Index name"
    },
    "source_excludes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Fields to exclude from _source"
    },
    "source_includes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Fields to include in _source"
    }
  }
}

elasticsearch_delete_document

Delete a document by ID from Elasticsearch.

Args:

index: The index name
id: The document ID
refresh: Whether to refresh the index after deletion

Returns: Delete response with result.

{
  "type": "object",
  "required": [
    "index",
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Document ID"
    },
    "index": {
      "type": "string",
      "description": "Index name"
    },
    "refresh": {
      "enum": [
        "true",
        "false",
        "wait_for"
      ],
      "type": "string",
      "description": "Refresh policy"
    }
  }
}

elasticsearch_update_document

Update a document in Elasticsearch using partial doc or script.

Args:

index: The index name
id: The document ID
doc: Partial document to merge (use this OR script)
script: Script to run for update (use this OR doc)
upsert: Document to insert if it doesn't exist
refresh: Whether to refresh after update
retry_on_conflict: Number of retries on version conflict

Returns: Update response with result.

{
  "type": "object",
  "required": [
    "index",
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Document ID"
    },
    "doc": {
      "type": "object",
      "description": "Partial document to merge"
    },
    "index": {
      "type": "string",
      "description": "Index name"
    },
    "upsert": {
      "type": "object",
      "description": "Document to insert if not exists"
    },
    "refresh": {
      "enum": [
        "true",
        "false",
        "wait_for"
      ],
      "type": "string",
      "description": "Refresh policy"
    },
    "retry_on_conflict": {
      "type": "integer",
      "minimum": 0,
      "description": "Retries on conflict"
    }
  }
}

elasticsearch_bulk

Execute bulk operations (index, create, update, delete) in Elasticsearch.

Args:

operations: Array of bulk operations (alternating action and optional source lines) Each operation is an object like: { "index": { "_index": "test", "_id": "1" } } Followed by source document for index/create/update operations
index: Default index for operations
refresh: Refresh policy
pipeline: Ingest pipeline

Example operations: [ { "index": { "_index": "test", "_id": "1" } }, { "field1": "value1" }, { "delete": { "_index": "test", "_id": "2" } }, { "update": { "_index": "test", "_id": "3" } }, { "doc": { "field2": "value2" } } ]

Returns: Bulk response with results for each operation.

{
  "type": "object",
  "required": [
    "operations"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Default index for operations"
    },
    "refresh": {
      "enum": [
        "true",
        "false",
        "wait_for"
      ],
      "type": "string",
      "description": "Refresh policy"
    },
    "pipeline": {
      "type": "string",
      "description": "Ingest pipeline"
    },
    "operations": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of bulk operations"
    }
  }
}

elasticsearch_delete_by_query

Delete documents matching a query in Elasticsearch.

Args:

index: The index name (or comma-separated list)
query: The query to match documents for deletion (Elasticsearch Query DSL)
refresh: Whether to refresh after deletion
conflicts: How to handle version conflicts ('abort' or 'proceed')
wait_for_completion: Whether to wait for the operation to complete

Returns: Delete by query response with deletion stats.

{
  "type": "object",
  "required": [
    "index",
    "query"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name(s)"
    },
    "query": {
      "type": "object",
      "description": "Query DSL to match documents"
    },
    "refresh": {
      "type": "boolean",
      "description": "Refresh after deletion"
    },
    "conflicts": {
      "enum": [
        "abort",
        "proceed"
      ],
      "type": "string",
      "description": "Conflict handling"
    },
    "wait_for_completion": {
      "type": "boolean",
      "description": "Wait for completion"
    }
  }
}

elasticsearch_update_by_query

Update documents matching a query in Elasticsearch.

Args:

index: The index name (or comma-separated list)
query: The query to match documents for update (Elasticsearch Query DSL)
script: Optional script to run for each matched document
refresh: Whether to refresh after update
conflicts: How to handle version conflicts ('abort' or 'proceed')
wait_for_completion: Whether to wait for the operation to complete

Returns: Update by query response with update stats.

{
  "type": "object",
  "required": [
    "index"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name(s)"
    },
    "query": {
      "type": "object",
      "description": "Query DSL to match documents"
    },
    "refresh": {
      "type": "boolean",
      "description": "Refresh after update"
    },
    "conflicts": {
      "enum": [
        "abort",
        "proceed"
      ],
      "type": "string",
      "description": "Conflict handling"
    },
    "wait_for_completion": {
      "type": "boolean",
      "description": "Wait for completion"
    }
  }
}

elasticsearch_reindex

Reindex documents from one index to another.

Args:

source_index: Source index name(s)
dest_index: Destination index name
query: Optional query to filter source documents
pipeline: Optional ingest pipeline for destination
refresh: Whether to refresh destination after reindex
wait_for_completion: Whether to wait for the operation to complete

Returns: Reindex response with stats.

{
  "type": "object",
  "required": [
    "source_index",
    "dest_index"
  ],
  "properties": {
    "query": {
      "type": "object",
      "description": "Query to filter source documents"
    },
    "refresh": {
      "type": "boolean",
      "description": "Refresh after reindex"
    },
    "pipeline": {
      "type": "string",
      "description": "Ingest pipeline for destination"
    },
    "dest_index": {
      "type": "string",
      "description": "Destination index name"
    },
    "source_index": {
      "type": "string",
      "description": "Source index name(s)"
    },
    "wait_for_completion": {
      "type": "boolean",
      "description": "Wait for completion"
    }
  }
}

elasticsearch_create_index

Create a new index in Elasticsearch.

Args:

index: The index name
settings: Optional index settings (shards, replicas, analysis, etc.)
mappings: Optional field mappings
aliases: Optional aliases to create with the index

Returns: Create index response with acknowledgment.

{
  "type": "object",
  "required": [
    "index"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name"
    },
    "aliases": {
      "type": "object",
      "description": "Aliases to create"
    },
    "mappings": {
      "type": "object",
      "description": "Field mappings"
    },
    "settings": {
      "type": "object",
      "description": "Index settings"
    }
  }
}

elasticsearch_delete_index

Delete one or more indices.

Args:

index: Index name(s) to delete (comma-separated or array)

Returns: Delete response with acknowledgment.

{
  "type": "object",
  "required": [
    "index"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name(s) to delete"
    }
  }
}

elasticsearch_get_index

Get index information including settings, mappings, and aliases.

Args:

index: Index name(s) to get

Returns: Index information.

{
  "type": "object",
  "required": [
    "index"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name(s)"
    }
  }
}

elasticsearch_index_exists

Check if an index exists.

Args:

index: Index name to check

Returns: Boolean indicating whether the index exists.

{
  "type": "object",
  "required": [
    "index"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name"
    }
  }
}

elasticsearch_get_mapping

Get field mappings for one or more indices.

Args:

index: Index name(s)

Returns: Field mappings for each index.

{
  "type": "object",
  "required": [
    "index"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name(s)"
    }
  }
}

elasticsearch_put_mapping

Update field mappings for an index.

Note: You can only add new fields or update specific field properties. You cannot change the type of an existing field.

Args:

index: Index name(s)
mappings: Mapping definition with properties

Returns: Acknowledgment.

{
  "type": "object",
  "required": [
    "index",
    "mappings"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name(s)"
    },
    "mappings": {
      "type": "object",
      "description": "Mapping definition"
    }
  }
}

elasticsearch_get_settings

Get settings for one or more indices.

Args:

index: Index name(s)
include_defaults: Whether to include default settings

Returns: Index settings.

{
  "type": "object",
  "required": [
    "index"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name(s)"
    },
    "include_defaults": {
      "type": "boolean",
      "description": "Include default settings"
    }
  }
}

elasticsearch_put_settings

Update settings for an index.

Note: Some settings can only be changed on a closed index.

Args:

index: Index name(s)
settings: Settings to update

Returns: Acknowledgment.

{
  "type": "object",
  "required": [
    "index",
    "settings"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name(s)"
    },
    "settings": {
      "type": "object",
      "description": "Settings to update"
    }
  }
}

elasticsearch_refresh

Refresh an index to make recent changes searchable.

Args:

index: Index name(s) to refresh (optional, all indices if not specified)

Returns: Refresh result with shard info.

{
  "type": "object",
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name(s)"
    }
  }
}

elasticsearch_flush

Flush an index to persist changes to disk.

Args:

index: Index name(s) to flush (optional, all indices if not specified)

Returns: Flush result with shard info.

{
  "type": "object",
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name(s)"
    }
  }
}

elasticsearch_forcemerge

Force merge index segments to reduce their number.

Useful for read-only indices to optimize storage and search performance.

Args:

index: Index name(s) to merge (optional, all indices if not specified)
max_num_segments: Target number of segments per shard
only_expunge_deletes: Only expunge deleted documents

Returns: Force merge result.

{
  "type": "object",
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name(s)"
    },
    "max_num_segments": {
      "type": "integer",
      "minimum": 1,
      "description": "Target segments per shard"
    },
    "only_expunge_deletes": {
      "type": "boolean",
      "description": "Only expunge deletes"
    }
  }
}

elasticsearch_close_index

Close an index to prevent read/write operations.

Closed indices consume minimal resources but cannot be searched or written to.

Args:

index: Index name(s) to close

Returns: Close result with acknowledgment.

{
  "type": "object",
  "required": [
    "index"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name(s)"
    }
  }
}

elasticsearch_open_index

Open a closed index to allow read/write operations.

Args:

index: Index name(s) to open

Returns: Open result with acknowledgment.

{
  "type": "object",
  "required": [
    "index"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name(s)"
    }
  }
}

elasticsearch_clone_index

Clone an index to a new index.

The source index must be set to read-only first.

Args:

source: Source index name
target: Target index name
settings: Optional settings for the new index
aliases: Optional aliases for the new index

Returns: Clone result with acknowledgment.

{
  "type": "object",
  "required": [
    "source",
    "target"
  ],
  "properties": {
    "source": {
      "type": "string",
      "description": "Source index name"
    },
    "target": {
      "type": "string",
      "description": "Target index name"
    },
    "aliases": {
      "type": "object",
      "description": "Aliases for new index"
    },
    "settings": {
      "type": "object",
      "description": "Settings for new index"
    }
  }
}

elasticsearch_shrink_index

Shrink an index to a new index with fewer shards.

The source index must be set to read-only and relocated to a single node.

Args:

source: Source index name
target: Target index name
settings: Optional settings for the new index
aliases: Optional aliases for the new index

Returns: Shrink result with acknowledgment.

{
  "type": "object",
  "required": [
    "source",
    "target"
  ],
  "properties": {
    "source": {
      "type": "string",
      "description": "Source index name"
    },
    "target": {
      "type": "string",
      "description": "Target index name"
    },
    "aliases": {
      "type": "object",
      "description": "Aliases for new index"
    },
    "settings": {
      "type": "object",
      "description": "Settings for new index"
    }
  }
}

elasticsearch_split_index

Split an index to a new index with more shards.

The source index must be set to read-only.

Args:

source: Source index name
target: Target index name
settings: Optional settings for the new index (must include target shard count)
aliases: Optional aliases for the new index

Returns: Split result with acknowledgment.

{
  "type": "object",
  "required": [
    "source",
    "target"
  ],
  "properties": {
    "source": {
      "type": "string",
      "description": "Source index name"
    },
    "target": {
      "type": "string",
      "description": "Target index name"
    },
    "aliases": {
      "type": "object",
      "description": "Aliases for new index"
    },
    "settings": {
      "type": "object",
      "description": "Settings for new index"
    }
  }
}

elasticsearch_search

Search for documents in Elasticsearch.

Args:

index: Index name(s) to search (comma-separated for multiple)
query: Elasticsearch Query DSL (e.g., { "match": { "title": "search" } })
size: Number of results to return (default: 10)
from: Offset for pagination (default: 0)
sort: Sort specification (e.g., [{ "date": "desc" }, "_score"])
source: Fields to include/exclude (_source filtering)
aggs: Aggregations to compute
highlight: Highlight configuration
track_total_hits: Whether to track total hits accurately
format: Response format ('json' or 'markdown')

Returns: Search results with hits and optional aggregations.

{
  "type": "object",
  "required": [
    "index"
  ],
  "properties": {
    "aggs": {
      "type": "object",
      "description": "Aggregations"
    },
    "from": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "description": "Offset for pagination"
    },
    "size": {
      "type": "integer",
      "default": 10,
      "maximum": 10000,
      "minimum": 0,
      "description": "Number of results"
    },
    "sort": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Sort specification"
    },
    "index": {
      "type": "string",
      "description": "Index name(s) to search"
    },
    "query": {
      "type": "object",
      "description": "Elasticsearch Query DSL"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "source": {
      "type": "string",
      "description": "Source filtering"
    },
    "highlight": {
      "type": "object",
      "description": "Highlight configuration"
    },
    "track_total_hits": {
      "type": "string",
      "description": "Track total hits"
    }
  }
}

elasticsearch_msearch

Execute multiple searches in a single request.

Args:

searches: Array of search definitions, each with optional index and body Example: [ { "index": "index1", "body": { "query": { "match_all": {} } } }, { "index": "index2", "body": { "query": { "term": { "status": "active" } } } } ]

Returns: Array of search responses.

{
  "type": "object",
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "type": "object",
      "description": "Search body"
    },
    "searches": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Index for this search"
    }
  }
}

elasticsearch_count

Count documents matching a query.

Args:

index: Index name(s) to count
query: Optional query to filter documents

Returns: Document count.

{
  "type": "object",
  "required": [
    "index"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name(s)"
    },
    "query": {
      "type": "object",
      "description": "Query to filter documents"
    }
  }
}

elasticsearch_explain

Explain why a document matches (or doesn't match) a query.

Args:

index: Index name
id: Document ID
query: Query to explain

Returns: Explanation of the match.

{
  "type": "object",
  "required": [
    "index",
    "id",
    "query"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Document ID"
    },
    "index": {
      "type": "string",
      "description": "Index name"
    },
    "query": {
      "type": "object",
      "description": "Query to explain"
    }
  }
}

elasticsearch_field_caps

Get field capabilities across indices.

Args:

index: Index name(s) to check
fields: Field names or patterns to check (e.g., ["", "title", "date"])
include_unmapped: Include unmapped fields

Returns: Field capabilities per field per index.

{
  "type": "object",
  "required": [
    "index",
    "fields"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name(s)"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Field names or patterns"
    },
    "include_unmapped": {
      "type": "boolean",
      "description": "Include unmapped fields"
    }
  }
}

elasticsearch_search_scroll_start

Start a scrolling search for large result sets.

Args:

index: Index name(s) to search
query: Elasticsearch Query DSL
size: Number of results per scroll batch
scroll: How long to keep the scroll context alive (e.g., "1m", "5m")
sort: Sort specification

Returns: First batch of results and a scroll_id for continuation.

{
  "type": "object",
  "required": [
    "index"
  ],
  "properties": {
    "size": {
      "type": "integer",
      "default": 100,
      "maximum": 10000,
      "minimum": 1,
      "description": "Batch size"
    },
    "sort": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Sort specification"
    },
    "index": {
      "type": "string",
      "description": "Index name(s)"
    },
    "query": {
      "type": "object",
      "description": "Query DSL"
    },
    "scroll": {
      "type": "string",
      "default": "1m",
      "description": "Scroll context timeout"
    }
  }
}

elasticsearch_search_scroll_continue

Continue a scrolling search.

Args:

scroll_id: The scroll ID from the previous search
scroll: How long to keep the scroll context alive

Returns: Next batch of results.

{
  "type": "object",
  "required": [
    "scroll_id"
  ],
  "properties": {
    "scroll": {
      "type": "string",
      "default": "1m",
      "description": "Scroll context timeout"
    },
    "scroll_id": {
      "type": "string",
      "description": "Scroll ID from previous search"
    }
  }
}

elasticsearch_search_scroll_clear

Clear one or more scroll contexts.

Args:

scroll_ids: Scroll ID(s) to clear

Returns: Clear result.

{
  "type": "object",
  "required": [
    "scroll_ids"
  ],
  "properties": {
    "scroll_ids": {
      "type": "string",
      "description": "Scroll ID(s) to clear"
    }
  }
}

elasticsearch_pit_open

Open a point-in-time for consistent search results.

Args:

index: Index name to create PIT for
keep_alive: How long to keep the PIT alive (e.g., "1m", "5m")

Returns: PIT ID for use in subsequent searches.

{
  "type": "object",
  "required": [
    "index"
  ],
  "properties": {
    "index": {
      "type": "string",
      "description": "Index name"
    },
    "keep_alive": {
      "type": "string",
      "default": "1m",
      "description": "PIT timeout"
    }
  }
}

elasticsearch_pit_close

Close a point-in-time.

Args:

pit_id: The PIT ID to close

Returns: Close result.

{
  "type": "object",
  "required": [
    "pit_id"
  ],
  "properties": {
    "pit_id": {
      "type": "string",
      "description": "PIT ID to close"
    }
  }
}

elasticsearch_put_index_template

Create or update an index template.

Args:

name: Template name
index_patterns: Array of index patterns this template applies to
template: Template settings, mappings, and aliases
composed_of: Optional component templates to compose
priority: Optional priority for conflicting patterns

Returns: Acknowledgment.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Template name"
    },
    "priority": {
      "type": "integer",
      "description": "Template priority"
    },
    "composed_of": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Component templates"
    },
    "index_patterns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Index patterns"
    }
  }
}

elasticsearch_delete_index_template

Delete an index template.

Args:

name: Template name to delete

Returns: Acknowledgment.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Template name"
    }
  }
}