DBX MCP Server: Setup for Claude Code, Cursor and Other Apps

• Lists the database connections you saved in DBX

  Returns your DBX connections with their names, groups, database types, endpoints and saved notes. Notes are visible to the assistant, so keep passwords out of them.

  Try: “List my DBX connections.”

  Read · dbx_list_connections

• Lists the databases on a connection

  Lists database names on a connection, limited to the ones DBX MCP settings allow.

  Try: “Which databases are on the production Postgres connection?”

  Read · dbx_list_databases

• Lists tables and views in a database

  Lists the tables and views for a connection. For some connection types it lists collections or message topics.

  Try: “Show the tables in the billing database.”

  Read · dbx_list_tables

• Shows a table's columns and details

  Returns column definitions and metadata for one table.

  Try: “Describe the orders table.”

  Read · dbx_describe_table

• Gives the assistant a compact summary of your tables and columns

  Returns compact table and column context so the assistant can write correct SQL.

  Try: “Build schema context for the billing database.”

  Read · dbx_get_schema_context

• Lists stored procedures and functions

  Lists stored procedures and functions in a schema.

  Try: “What stored procedures exist in the public schema?”

  Read · dbx_list_routines

• Shows the code of a stored procedure or function

  Returns the full source text of a stored procedure or function.

  Try: “Show me the source of calculate_invoice.”

  Read · dbx_get_routine_source

• Runs a SQL query or MongoDB command and returns rows

  Runs a query on a connection and returns 100 rows by default, up to 1000. What it may change depends on the permission mode you set in DBX: read only, data read/write or full access.

  Try: “Count orders created in the last seven days.”

  Delete · dbx_execute_query

• Runs a script of several SQL statements at once

  Runs a multi-statement SQL script and returns a result per statement. It can run the whole script inside one transaction.

  Try: “Run these three migration statements in one transaction.”

  Delete · dbx_execute_batch

• Starts a session that keeps settings between queries

  Opens a session pinned to one connection so temporary tables and session settings persist across calls. Idle sessions expire after 30 minutes by default.

  Try: “Open a session and create a temp table for my report.”

  Network · dbx_open_session

• Ends a query session

  Closes a session and releases its connection.

  Try: “Close the session.”

  Read · dbx_close_session

• Starts a database transaction

  Begins a transaction on a transaction-enabled native MySQL session.

  Try: “Begin a transaction before the updates.”

  Write · dbx_begin_transaction

• Saves the changes made in a transaction

  Commits the active transaction. It reports success only after MySQL acknowledges the commit.

  Try: “Commit the transaction.”

  Write · dbx_commit_transaction

• Undoes the changes made in a transaction

  Rolls back the active transaction.

  Try: “Roll back the transaction.”

  Write · dbx_rollback_transaction

• Runs a Redis command

  Runs a Redis command on a Redis connection. The permission mode decides which commands are allowed, and unknown commands are refused.

  Try: “Run INFO memory on the Redis connection.”

  Delete · dbx_execute_redis_command

• Reads Kafka messages without marking them as read

  Reads up to 100 Kafka messages without committing consumer offsets. It defaults to the latest 20.

  Try: “Show the latest 10 messages on the orders topic.”

  Network · dbx_peek_messages

• Sends a message to a Kafka, RocketMQ or RabbitMQ topic

  Sends a base64-encoded message to a topic or queue.

  Try: “Send a test message to the alerts topic.”

  Write · dbx_send_message

• Adds a new database connection to DBX

  Adds a connection to DBX storage.

  Try: “Add a connection to my staging MySQL server.”

  Write · dbx_add_connection

• Copies an existing connection with its settings

  Duplicates a DBX connection, including its credentials, tunnels and sidebar group.

  Try: “Duplicate the staging connection as staging-2.”

  Write · dbx_duplicate_connection

• Deletes a connection from DBX

  Removes a database connection from DBX storage.

  Try: “Remove the old-test connection.”

  Delete · dbx_remove_connection

• Opens a table in the DBX desktop app

  Opens a table in the running DBX app. DBX must be running.

  Try: “Open the orders table in DBX.”

  Read · dbx_open_table

• Runs a query and shows the result in the DBX app

  Runs a SQL query in the DBX desktop app and shows the results there. DBX must be running.

  Try: “Run this query and show me the results in DBX.”

  Delete · dbx_execute_and_show

• Shows which Salesforce user and org a connection uses

  Shows the connected Salesforce user, profile, whether the profile holds Modify All Data, and the org. Read only.

  Try: “Who am I connected to Salesforce as?”

  Network · dbx_salesforce_current_user

• Prepares one Salesforce record change for your approval

  Step one of two. It checks a single-record insert, update or delete against policy and returns a summary and a one-time token. Nothing is sent to Salesforce yet.

  Try: “Prepare an update to set this account's rating to Hot.”

  Read · dbx_salesforce_prepare_write

• Applies a prepared Salesforce change

  Step two of two. It runs exactly the prepared write using its token, which is single-use and expires after 5 minutes. Salesforce cannot roll an applied write back.

  Try: “Apply the prepared Salesforce update.”

  Delete · dbx_salesforce_apply_write

• Lists Nacos namespaces

  Lists the namespaces of a Nacos connection that DBX can display.

  Try: “List the namespaces on my Nacos connection.”

  Network · dbx_nacos_list_namespaces

• Lists configurations in a Nacos namespace

  Lists Nacos configurations with optional group, name and text filters and paging.

  Try: “List the configs in the prod namespace.”

  Network · dbx_nacos_list_configs

• Reads one Nacos configuration

  Reads the content and metadata of one Nacos configuration.

  Try: “Show the config order-service.yaml.”

  Network · dbx_nacos_get_config

• Searches the content of Nacos configurations

  Searches configuration content in one namespace or all of them.

  Try: “Find configs that mention redis.host.”

  Network · dbx_nacos_search_configs

• Shows the publish history of a Nacos configuration

  Lists the publish history of one Nacos configuration.

  Try: “Show the history of order-service.yaml.”

  Network · dbx_nacos_config_history

• Creates or overwrites a Nacos configuration

  Creates or overwrites one Nacos configuration. A checksum from the read tool can be passed to avoid overwriting a concurrent change.

  Try: “Publish this YAML as order-service.yaml.”

  Write · dbx_nacos_publish_config

• Restores an older version of a Nacos configuration

  Rolls a Nacos configuration back to a chosen history entry.

  Try: “Roll order-service.yaml back to the previous version.”

  Write · dbx_nacos_rollback_config

• Deletes a Nacos configuration

  Deletes one Nacos configuration. The tool is marked high risk and needs a high-risk permission or desktop confirmation.

  Try: “Delete the config old-service.yaml.”

  Delete · dbx_nacos_delete_config

• Lists Nacos services

  Lists Nacos services in a namespace, optionally filtered by group and name.

  Try: “List the services in the prod namespace.”

  Network · dbx_nacos_list_services

• Shows details of one Nacos service

  Gets details for one Nacos service.

  Try: “Show the payment service details.”

  Network · dbx_nacos_get_service

• Lists the instances of a Nacos service

  Lists a service's instances with health, weight and enabled state.

  Try: “Which instances of payment are healthy?”

  Network · dbx_nacos_list_instances

• Takes a Nacos instance online or offline or changes its weight

  Brings a Nacos instance online or offline or changes its weight.

  Try: “Take the 10.0.0.5 payment instance offline.”

  Write · dbx_nacos_update_instance

• Registers a persistent Nacos service instance

  Registers a persistent instance for a Nacos service.

  Try: “Register 10.0.0.9:8080 as a payment instance.”

  Write · dbx_nacos_register_instance

• Removes a Nacos service instance

  Deregisters a Nacos service instance. It targets persistent instances unless you say otherwise.

  Try: “Deregister 10.0.0.9:8080 from payment.”

  Delete · dbx_nacos_deregister_instance

• Lists Consul key-value keys under a prefix

  Lists Consul KV keys under a prefix, one page at a time.

  Try: “List the Consul keys under config/.”

  Network · dbx_consul_kv_list

• Reads one Consul key

  Reads one Consul KV key with its value and a version number used for safe writes.

  Try: “Read the Consul key config/db/host.”

  Network · dbx_consul_kv_get

• Writes one Consul key

  Writes a Consul KV key. A version check is required so you do not overwrite someone else's change.

  Try: “Set config/db/host to db2.internal.”

  Write · dbx_consul_kv_put

• Deletes one Consul key

  Deletes a Consul KV key. Marked high risk, so it needs a high-risk permission or desktop confirmation.

  Try: “Delete the key config/old/flag.”

  Delete · dbx_consul_kv_delete

• Lists Consul services and tags

  Lists the services in the Consul catalog with their tags.

  Try: “What services are in Consul?”

  Network · dbx_consul_list_services

• Lists Consul nodes

  Lists the nodes in the Consul catalog.

  Try: “List the Consul nodes.”

  Network · dbx_consul_list_nodes

• Shows the health checks for a Consul service

  Lists a service's instances with their health checks.

  Try: “Is the api service healthy in Consul?”

  Network · dbx_consul_service_health

• Puts a Consul service into or out of maintenance

  Puts a Consul agent service into or out of maintenance mode.

  Try: “Put the api service into maintenance mode.”

  Write · dbx_consul_set_maintenance

• Runs a tool that a DBX plugin provides

  Calls one plugin tool by plugin id and tool name. DBX supplies the connection and credentials. What it does depends on the plugin.

  Try: “Use the Kafka plugin to list topics.”

  Delete · dbx_plugin_call

• Used by the assistant behind the scenes

  Lists DBX plugins that add their own tools

  Lists DBX plugins that contribute tools, with how many tools and connections each has.

  Try: “Which DBX plugins add tools?”

  Read · dbx_plugin_list

• Lists the tools a DBX plugin provides

  Lists the tools of one DBX plugin, with arguments and a read-only hint.

  Try: “What tools does the Kafka plugin have?”

  Read · dbx_plugin_tools

Watch out for

• Full access allows DDL and deletes

  In Full access it can drop tables, truncate data and run broad updates or deletes. Pick Read only in DBX unless you need writes. github.com

• It can remove connections and Nacos or Consul data

  Tools can delete DBX connections, Nacos configurations and Consul keys. Delete tools are marked high risk and may need a confirmation in the DBX app. github.com

• Saved connection notes are visible to the assistant

  Connection notes are returned with the connection list. Do not store passwords or secrets in notes. github.com

• Plugin tools are open-ended

  One tool runs tools that DBX plugins provide, such as SSH or Kubernetes plugins in the source. Check which plugins are installed before enabling them. github.com

Security advisories