Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Databases - official Oracle server

Oracle SQLcl MCP server

MCP server built into Oracle SQLcl (started with sql -mcp) that lets AI clients connect to Oracle AI Database through saved SQLcl connections and run SQL, PL/SQL and SQLcl commands. It runs locally; the notes below cover how it authenticates.

Last verified 6 tools6 sources

Install

Generic

JSON
{
  "mcpServers": {
    "sqlcl": {
      "command": "PATH/bin/sql",
      "args": ["-mcp"],
      "env" : {"TNS_ADMIN" : "/PATH"}
     }
   }
 }

Tools

list-connections
Discovers and lists saved Oracle Database connections on the machine.
connect
Connects to one of the named connections.
disconnect
Terminates the current Oracle Database connection.
run-sql
Executes SQL queries and PL/SQL blocks against the connected database.
run-sqlcl
Executes SQLcl-specific commands and extensions.
schema-information
Provides details about the currently connected schema.

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Replace PATH/bin/sql with the absolute path of the SQLcl install.
  • Credentials stay in SQLcl saved connections on the user's machine.
  • SQL Developer for VS Code registers the server automatically for GitHub Copilot.
  • Restrict levels control which commands can run; activity is logged to DBTOOLS$MCP_LOG.
  • Documented in SQLcl 26.2.

FAQ

What does the Oracle SQLcl MCP server do?

MCP server built into Oracle SQLcl (started with sql -mcp) that lets AI clients connect to Oracle AI Database through saved SQLcl connections and run SQL, PL/SQL and SQLcl commands. The vendor documents 6 tools, including list-connections, connect, disconnect and run-sql.

How do I add the Oracle SQLcl MCP server to an MCP client?

Oracle documents a Generic config; copy it from the Generic section of this page.

Does the Oracle SQLcl MCP server need authentication?

It uses a scheme other than OAuth or an API key, such as the session of the app or instance it runs in; the notes on this page describe it. Transport: stdio. Status: GA, last checked October 17, 2026.

Sources

Last verified against 6 Oracle pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.