Bring Mysql
to Windsurf
Create your Vinkius account to connect PlanetScale to Windsurf and start using all 10 AI tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code. No hosting, no server setup — just connect and start using.
Compatible with every major AI agent and IDE
What is the PlanetScale MCP Server?
Empower your AI agents to manage your PlanetScale serverless infrastructure seamlessly. Leverage the power of Vitess-backed MySQL without leaving your IDE. Ask your AI to branch a production database for testing, list regions, or drop obsolete schema forks instantly.
What you can do
- Database Provisioning — Instantly list (
list_databases), inspect, create (create_database), or destroy serverless MySQL clusters running across global regions. - Branch Management — Harness PlanetScale's Git-like schema workflows. Direct your LLM to spawn a temporary
shadow-testbranch cloned frommain(create_branch), allowing consequence-free migrations before orchestrating Deploy Requests. - Infrastructure Exploration — Discover strict organizational IDs (
list_organizations) and query available physical cloud provider edges (list_regions) to optimize latency targets.
How it works
- Ensure your AI environment has this connector subscribed
- Provide an active PlanetScale Service Token
- Manage fleets of serverless data clusters via natural language inside Cursor or Claude
Who is this for?
- DevOps Engineers — automate the destruction of stale staging branches (
delete_branch) via simple LLM terminal chat commands. - Full-stack Developers — spin up ephemeral database branches for isolated feature development without touching the web console.
- Platform Architects — audit distribution footprints, node metadata, and connection strings across multiple organizational environments automatically.
Built-in capabilities (10)
Does *not* duplicate data (creates an empty schema clone of the parent) for secure CI testing uncoupled entirely from `main` load balancing layers. Fork a PlanetScale schema mapping to a new isolated Branch
Creates empty environments ready to execute explicit DDL definitions via non-blocking Deploy Requests. Provision a radically scalable Serverless Database instance
Utilized constantly within CI/CD pipelines following a successful Deploy Request morphing `main` schema structure directly. Purge an obsolete Git-like Schema testing ground
Dropping the database effectively wipes terabytes of records scattered globally. Fails fully if unacknowledged connection logic binds it. Destroy a PlanetScale MySQL construct irreversibly
Returns access hostnames for code integration. Deconstruct the layout of a single explicit Database Branch
Analyze core configuration of a specific MySQL cluster logic
Essential for migrating schemas without locking production reads/writes. List Development Database Branches mirroring Prod architectures
Retrieves explicitly mapping IDs orchestrating distributed Vitess backend shards. List high-availability PlanetScale MySQL DB distributions
Used solely to resolve the foundational string key prerequisite for all subsequent MySQL endpoint management. List root PlanetScale organizational identifiers
Critical reference required during new Database/Branch physical provisioning routines. Locate physical edge availability zones supported by Vitess
Why Windsurf?
Windsurf's Cascade agent chains multiple PlanetScale tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 10 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
- —
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
- —
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
- —
JSON-based configuration means zero code changes: paste a URL, reload, and all 10 tools are immediately available
- —
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
PlanetScale in Windsurf
Why run PlanetScale with Vinkius?
The PlanetScale connection runs on our fully managed, secure cloud infrastructure. We handle the hosting, maintenance, and security so you don't have to deal with servers or code. All 10 tools are ready to work instantly without any complex setup.
You stay in complete control of your data. Your AI only accesses the information you approve, keeping your sensitive passwords and private details completely safe. Plus, with automatic optimizations, your AI works faster and more efficiently.

* Every connection is hosted and maintained by Vinkius. We handle the security, updates, and infrastructure so you don't have to write code or manage servers. See our infrastructure
Over 4,000 integrations ready for AI agents
Explore a vast library of pre-built integrations, optimized and ready to deploy.
Connect securely in under 30 seconds
Generate tokens to authenticate and link external services in a single step.
Complete visibility into every agent action
Audit live requests, latency, success rates, and active security compliance policies.
Optimize spending and track token ROI
Analyze real-time token consumption and cost metrics detailed by connection.




Explore our live AI Agents Analytics dashboard to see it all working
This dashboard is included when you connect PlanetScale using Vinkius. You will never be left in the dark about what your AI agents are doing with your tools.
PlanetScale and 4,000+ other AI tools. No hosting, no code, ready to use.
Professionals who connect PlanetScale to Windsurf through Vinkius don't need to write code, manage servers, or worry about security. Everything is pre-configured, secure, and runs automatically in the background.
Raw MCP | Vinkius | |
|---|---|---|
| Ready-to-use MCPs | Find and configure each manually | 4,000+ MCPs ready to use |
| Connection Setup | Manual coding & server setup | 1-click instant connection |
| Server Hosting | You host it yourself (needs 24/7 uptime) | 100% hosted & managed by Vinkius |
| Security & Privacy | Stored in plaintext config files | Bank-grade encrypted vault |
| Activity Visibility | Blind execution (no logs or tracking) | Live dashboard with real-time logs |
| Cost Control | Runaway AI token spend risk | Automatic budget limits |
| Revoking Access | Must delete files or code to stop | 1-click disconnect button |
How Vinkius secures
PlanetScale for Windsurf
Every request between Windsurf and PlanetScale is protected by our secure gateway. We automatically keep your sensitive data private, prevent unauthorized access, and let you disconnect instantly at any time.
Frequently asked questions
Can I run destructive commands like deleting databases through this AI implementation?
Yes. The integration provides delete_branch and delete_database. They map directly to infrastructure teardowns. You should scope the Service Token carefully inside the PlanetScale dashboard to avoid catastrophic misinterpretations if your explicit intent is just testing. Deletions via delete_database are absolute and irretrievable.
Does `create_branch` replicate and copy my production dataset into the new branch?
No. PlanetScale branches solely duplicate the static underlying DDL structure (schema), exactly like taking a snapshot of empty tables. The new branch boots up free of rows. This design lets your agent freely run ALTER TABLE operations independently without crashing the master tables.
How does the agent know which organizational node I am provisioning my branches on?
All queries essentially require the foundational string parameters known as the org_name. If unknown, a simple list_organizations query reveals the UUID scope dictating your authorized account parameter bounds securely.
How does Windsurf discover MCP tools?
Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.
Can Cascade chain multiple MCP tool calls?
Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.
Does Windsurf support multiple MCP servers?
Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.
Server not connecting
Check Settings → MCP for the server status. Try toggling it off and on.
Explore More MCP Servers
View all →
Dola Checkout
12 toolsAccept payments globally with a checkout experience designed for digital products, subscriptions, and one-time purchases.

UserStack User-Agent Lookup
1 toolsUniversal User-Agent intelligence — detect devices, browsers, and OS via AI.

Hygraph (Headless CMS)
10 toolsManage headless content via Hygraph — execute GraphQL queries, introspect schemas, and manage documents.

Moosend (Email Marketing & Automation)
10 toolsManage email marketing via Moosend — create campaigns, track mailing lists, and audit performance analytics.
