Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.querybear.com/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks through connecting MySQL (or MariaDB) to Windsurf using QueryBear’s managed MCP server. End result: Windsurf’s Cascade agent can query your MySQL database while it codes.

​
What you’ll need

  • A QueryBear account (sign up free)
  • A MySQL or MariaDB database (5.7+ / 10.x+)
  • Windsurf installed

​
Step 1: Create a read-only MySQL user

CREATE USER 'querybear'@'%' IDENTIFIED BY 'choose-a-strong-one';
GRANT SELECT ON your_db.* TO 'querybear'@'%';
GRANT SHOW VIEW ON your_db.* TO 'querybear'@'%';
FLUSH PRIVILEGES;

​
Step 2: Add the connection to QueryBear

Dashboard → Connections → New connection → MySQL, with the credentials from Step 1.

​
Step 3: Add QueryBear to Windsurf

1

Open Windsurf Settings

Settings → MCP Servers → Add custom server.
2

Paste the config

{
  "mcpServers": {
    "querybear": {
      "serverUrl": "https://mcp.querybear.com/mcp"
    }
  }
}
Windsurf uses serverUrl — easy to miss if you’re copy-pasting from Cursor.
3

Save and authorize

First QueryBear tool call triggers OAuth in browser.

​
Step 4: Verify

In Cascade:
“What QueryBear tools do you have? List my connections.”

​
Try it

“In our MySQL DB, find users who signed up but never completed onboarding. Outline the queries you’d run first.”
Cascade plans the query (SELECT u.* FROM users u LEFT JOIN onboarding_events o ... WHERE o.id IS NULL), gets your go-ahead, then runs it through QueryBear.

​
MySQL + Windsurf gotchas

  • serverUrl not url. Top mistake — Cursor uses url, Windsurf uses serverUrl.
  • Cascade multi-steps — get_schema → run_query → maybe get_schema again. Normal.
  • For RDS or IP-restricted MySQL, allow QueryBear’s egress IP in your security group.
  • Multi-statement queries are blocked at the parser.