<a id="flink-sql-alter-tool"></a>

# ALTER TOOL Statement in Confluent Cloud for Apache Flink

Modify an existing tool’s configuration. Use the [CREATE TOOL](create-tool.md#flink-sql-create-tool) statement to create a tool.

## Syntax

```sql
ALTER TOOL [IF EXISTS] [catalog.][database.]tool_name
SET (key1=val1[,key=val]*)
```

## Description

Modify an existing tool’s configuration. You can rename the tool, update
its options, or reset specific options to their defaults.

## Operations

### Rename tool

Rename a tool to a new name:

```sql
ALTER TOOL old_tool_name RENAME TO new_tool_name;
```

### Set options

Update tool options:

```sql
ALTER TOOL tool_name SET (
  'description' = 'Updated tool description',
  'request_timeout' = '60'
);
```

## Parameters

- **IF EXISTS** (Optional): Do not throw an error if the tool does not exist
- **catalog.database** (STRING, Optional): Optional catalog and database name
- **tool_name** (STRING): Name of the tool to modify
- **tool_name1** (STRING): New name for the tool (RENAME operation)
- **key1=val1** (STRING): Key-value pairs for option updates (SET operation)
- **key1** (STRING): Option names to reset (RESET operation)

## Example

Update tool options:

```sql
ALTER TOOL mcp_server SET (
  'description' = 'Updated MCP server for weather data',
  'request_timeout' = '120'
);
```

## Related content

- [Call Tools in AI Workflows](../../../ai/streaming-agents/call-tools.md#streaming-agents-call-tools)
- [CREATE TOOL Statement](create-tool.md#flink-sql-create-tool)
- [DROP TOOL Statement](drop-tool.md#flink-sql-drop-tool)
- [SHOW TOOLS Statement](show.md#flink-sql-show-tools)

#### NOTE
This website includes content developed at the [Apache Software Foundation](https://www.apache.org/)
under the terms of the [Apache License v2](https://www.apache.org/licenses/LICENSE-2.0.html).