About AgentMode ✨
AgentMode is an MCP server for coding AI that connects to databases, data warehouses, and data pipelines. It supports a broad set of database connections with configurable read-only access.
Key features
- 01Connects to multiple database systems
- 02Supports data warehouses and pipelines
- 03Configurable connection credentials
- 04Read-only connection option
Use cases
- 01Querying connected databases through coding AI
- 02Connecting AI workflows to warehouse data
MCP support
Exposes database and data-source connections to MCP clients, including coding AI. Each connection is configured with host, port, credentials, database name, and optional read-only access.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEAgentMode ✨
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.
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:
hostportusernamepassworddatabase_nameread_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:
mysqlpostgresqlbigqueryredshiftsnowflakemariadbvitesstimescaledbsqlservercockroachdboraclesap_hanaclickhouseprestohivetrinobigqueryredshiftsnowflakedatabricksteradataaws_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=OR
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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.