MCP Tool Reference High Risk

esql

Perform an ES|QL query

Part of the Elasticsearch MCP server. Enforce policies on this tool with Intercept, the open-source MCP proxy.

mcp-server-elasticsearch Execute

WHEN AI AGENTS USE THIS TOOL

AI agents invoke esql to trigger processes or run actions in Elasticsearch. Execute operations can have side effects beyond the immediate call — triggering builds, sending notifications, or starting workflows. Rate limits and argument validation are essential to prevent runaway execution.

WHY ENFORCE A POLICY ON ESQL

esql can trigger processes with real-world consequences. An uncontrolled agent might start dozens of builds, send mass notifications, or kick off expensive compute jobs. Intercept enforces rate limits and validates arguments to keep execution within safe bounds.

RECOMMENDED POLICY

Execute tools trigger processes. Rate-limit and validate arguments to prevent unintended side effects.

elasticsearch.yaml 
tools:
  esql:
    rules:
      - action: allow
        rate_limit:
          max: 10
          window: 60
        validate:
          required_args: true

See the full Elasticsearch policy for all 5 tools.

DETAILS

Tool Name

esql

Category

Execute

MCP Server

Elasticsearch MCP Server

Risk Level

High

MORE ELASTICSEARCH TOOLS

list_indices Read
List all available Elasticsearch indices
get_mappings Read
Get field mappings for a specific Elasticsearch index
search Read
Perform an Elasticsearch search with the provided query DSL
get_shards Read
Get shard information for all or specific indices

SIMILAR EXECUTE TOOLS ON OTHER SERVERS

call-actor Apify
Call an Actor and get its run results
boot_simulator Appium
Boot an iOS simulator
setup_wda Appium
Download and setup WebDriverAgent for iOS simulators
install_wda Appium
Install and launch WebDriverAgent on an iOS simulator
auth0_deploy_action Auth0
Deploy an Auth0 action
auth0_publish_form Auth0
Publish an Auth0 form

RELATED READING

FREQUENTLY ASKED QUESTIONS

What does the esql tool do?

Perform an ES|QL query. It is categorised as a Execute tool in the Elasticsearch MCP Server, which means it can trigger actions or run processes. Use rate limits and argument validation.

How do I enforce a policy on esql?

Add a rule in your Intercept YAML policy under the tools section for esql. You can allow, deny, rate-limit, or validate arguments. Then run Intercept as a proxy in front of the Elasticsearch MCP server.

What risk level is esql?

esql is a Execute tool with high risk. Execute tools should be rate-limited and have argument validation enabled.

Can I rate-limit esql?

Yes. Add a rate_limit block to the esql rule in your Intercept policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block esql completely?

Set action: deny in the Intercept policy for esql. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides esql?

esql is provided by the Elasticsearch MCP server (mcp-server-elasticsearch). Intercept sits as a proxy in front of this server to enforce policies before tool calls reach the server.

ENFORCE POLICIES ON ELASTICSEARCH

Open source. One binary. Zero dependencies.

VIEW ON GITHUB Full Elasticsearch policy →