AgentMode ✨

AgentMode is an all-in-one Model Context Protocol (MCP) server that connects your coding AI to dozens of databases, data warehouses, and data pipelines.

flow diagram!

Installation 👨‍💻

Quick start for VS Code, and VS Code Insiders

(replace the credentials in the config with your own, and see the instructions below for how to add other databases)

Configuring database connections

Start with MCP server by installing uv if you haven't already, then run: uvx agentmode from your terminal.

You can configure each database connection by specifying the following parameters:

host
port
username
password
database_name
read_only

For example, to configure a MySQL connection, use the following arguments:

uvx agentmode \
--mysql:host host \
--mysql:port port \
--mysql:username username \
--mysql:password password \
--mysql:database_name database_name \
--mysql:read_only true

The full list of supported databases is:

mysql
postgresql
bigquery
redshift
snowflake
mariadb
vitess
timescaledb
sqlserver
cockroachdb
oracle
sap_hana
clickhouse
presto
hive
trino
bigquery
redshift
snowflake
databricks
teradata
aws_athena

Manual MCP configuration for VS Code

Please create a .vscode/settings.json file in your workspace, and add the following: ```json { "mcp": { "servers": { "agentmode": { "command": "uvx agentmode", "args": [ "--mysql:host", "host", "--mysql:port", "port", "--mysql:username", "username", "--mysql:password", "password", "--mysql:database_name", "database_name", "--mysql:read_only", "true" ] } } } } ```

Manual MCP configuration for Cursor

Copy and paste this link into your browser: cursor://anysphere.cursor-deeplink/mcp/install?name=agentmode&config=eyJhZ2VudG1vZGUiOnsiY29tbWFuZCI6InV2eCBhZ2VudG1vZGUiLCJhcmdzIjpbIi0tbXlzcWw6aG9zdCIsImhvc3QiLCItLW15c3FsOnBvcnQiLCJwb3J0IiwiLS1teXNxbDp1c2VybmFtZSIsInVzZXJuYW1lIiwiLS1teXNxbDpwYXNzd29yZCIsInBhc3N3b3JkIiwiLS1teXNxbDpkYXRhYmFzZV9uYW1lIiwiZGF0YWJhc2VfbmFtZSIsIi0tbXlzcWw6cmVhZF9vbmx5IiwidHJ1ZSJdfX0=

Please create a ~/.cursor/mcp.json file in your home directory. This makes MCP servers available in all your Cursor workspaces.

{
    "mcpServers": {
        "inputs": [],
        "servers": {
            "agentmode": {
                "command": "uvx agentmode",
                "args": [
                    "--mysql:host", "host",
                    "--mysql:port", "port",
                    "--mysql:username", "username",
                    "--mysql:password", "password",
                    "--mysql:database_name", "database_name",
                    "--mysql:read_only", "true"
                ]
            }
        }
    }
}

MCP configuration for Windsurf

Open the file ~/.codeium/windsurf/mcp_config.json Add the code below to the JSON file. Press the refresh button in Windsurf. Please replace 'YOUR_INSTALLATION_FOLDER' below with the folder you setup your uv environment in:

{
    "mcpServers": {
        "servers": {
            "agentmode": {
                "command": "uvx agentmode",
                "args": [
                    "--mysql:host", "host",
                    "--mysql:port", "port",
                    "--mysql:username", "username",
                    "--mysql:password", "password",
                    "--mysql:database_name", "database_name",
                    "--mysql:read_only", "true"
                ]
            }
        }
    }
}

Help 🛟

If you encounter any issues or have questions, you can:

See the documentation.
Open an issue in the GitHub repository.
Chat with us on our Discord server.

Contributing 💬

add more connectors & tests