Skip to directory

About Oracle SQLcl MCP

Local SQLcl MCP for connecting to saved database connections, listing connections, executing SQLcl/SQL, disconnecting, and connection assistance.

What you can use it for

  • Connect to saved database connections, run SQL and SQLcl commands, inspect connection lists, and disconnect.
Connection and setup
Hosting
Local MCP server
Transport
stdio
Endpoint
Local process; no hosted endpoint documented
Authentication
Local process; Oracle SQLcl 25.2 or later, Java 17 or later, and saved database credentials are required.

Requirements

  • Oracle SQLcl version 25.2 or later.
  • A configured/saved SQLcl connection to an Oracle Database.
  • MCP client supporting stdio.

Setup steps

  1. Install Oracle SQLcl 25.2 or later from Oracle’s official distribution.
  2. Create and verify a saved SQLcl database connection; follow Oracle documentation for secure credential saving.
  3. Configure the MCP client to start SQLcl with the documented `sql -mcp` command.
  4. Review the exposed SQL/PLSQL tool permissions and begin with a read-only query.
Tools 6

Six exact names are listed in the SQLcl 25.2 guide.

  • connect

    Oracle SQLcl MCP Server documented operation: connect.

    01
  • list-connections

    Oracle SQLcl MCP Server documented operation: list-connections.

    02
  • run-sqlcl

    Oracle SQLcl MCP Server documented operation: run-sqlcl.

    03
  • run-sql

    Oracle SQLcl MCP Server documented operation: run-sql.

    04
  • disconnect

    Oracle SQLcl MCP Server documented operation: disconnect.

    05
  • connection-helper

    Oracle SQLcl MCP Server documented operation: connection-helper.

    06
Limitations and notes
  • SQL execution acts against configured databases; only connect to authorized saved connections.
Original sources

Documentation checked 2026-10-28T00:00:00Z. Connection has not been runtime tested.

Similar tools