PlanetScale Connector for AI agents.
10 live capabilities
Manage distributed MySQL database branches and clusters via natural language.
Waiting for input…
Why people use PlanetScale
PlanetScale for Automated MySQL Branching
With this Connector, that workflow disappears. You can simply tell your agent to fork a branch for a specific feature. It handles the creation of the isolated schema clone, giving you a safe sandbox to work in immediately. You move from manual clicking to instant execution.
What Vinkius changes
You get full control over your MySQL infrastructure through a chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Safe migration testing
A developer needs to test a heavy DDL change.
- Real-world use case 02
Rapid dev environment setup
A new project starts and the team needs a database.
- Real-world use case 03
Staging environment cleanup
A DevOps engineer wants to clear out old tests.
Complete set · 10capabilities
The complete PlanetScale capability set.
These are the exact actions your AI can choose when you ask it to work with PlanetScale.
01—04
4 capabilities in this set.
Part of 10 available through PlanetScale.
- 01 Capability
Create database
Provision a new managed MySQL cluster ready for your DDL commands.
- 02 Capability
Delete branch
Remove a specific schema branch from your database once you are done testing.
- 03 Capability
Delete database
Irreversibly destroy a PlanetScale MySQL cluster to stop its billing.
- 04 Capability
Get branch
Get the specific hostnames and connection details for a database branch.
05—07
3 capabilities in this set.
Part of 10 available through PlanetScale.
- 05 Capability
Get database
View the core configuration details of a specific MySQL cluster.
- 06 Capability
List branches
See all the development branches currently mirroring your production architecture.
- 07 Capability
List databases
List all the high-availability MySQL distributions in your account.
08—10
3 capabilities in this set.
Part of 10 available through PlanetScale.
- 08 Capability
Create branch
Create a new schema branch that mirrors the parent structure but does not copy any data.
- 09 Capability
List organizations
Get the root organizational IDs needed for managing your MySQL endpoints.
- 10 Capability
List regions
Find all the physical cloud availability zones supported by the Vitess backend.
Set up in minutes
One URL. Then ask PlanetScale to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use PlanetScale from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_Cj1wlp2M7NG4xG8y4bWLeF2TWX2ttuftARXCdWYR/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it PlanetScale, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable PlanetScale for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_Cj1wlp2M7NG4xG8y4bWLeF2TWX2ttuftARXCdWYR/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the PlanetScale URL.
- Step 03
Save and start
Save the connection and enable PlanetScale in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"planetscale": {
"url": "https://edge.vinkius.com/vk_preview_Cj1wlp2M7NG4xG8y4bWLeF2TWX2ttuftARXCdWYR/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using PlanetScale
Open Agent mode in chat and ask: "Using PlanetScale, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"planetscale": {
"url": "https://edge.vinkius.com/vk_preview_Cj1wlp2M7NG4xG8y4bWLeF2TWX2ttuftARXCdWYR/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using PlanetScale
Ask Copilot: "Using PlanetScale, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"planetscale": {
"url": "https://edge.vinkius.com/vk_preview_Cj1wlp2M7NG4xG8y4bWLeF2TWX2ttuftARXCdWYR/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using PlanetScale
Open Cascade and ask: "Using PlanetScale, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"planetscale": {
"url": "https://edge.vinkius.com/vk_preview_Cj1wlp2M7NG4xG8y4bWLeF2TWX2ttuftARXCdWYR/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using PlanetScale
Ask Cline: "Using PlanetScale, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add planetscale --transport http "https://edge.vinkius.com/vk_preview_Cj1wlp2M7NG4xG8y4bWLeF2TWX2ttuftARXCdWYR/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using PlanetScale
Ask Claude: "Using PlanetScale, show me...". 10 tools are ready
Where the request belongs
Work PlanetScale can move forward.
This is for the engineer who is tired of manual console clicking to manage database branches or who needs to spin up dev environments quickly without waiting on a DevOps ticket.
DevOps Engineer
Automates the cleanup of stale staging branches and audits regional distribution footprints.
Full-stack Developer
Spins up ephemeral database branches for isolated feature testing during a sprint.
Platform Architect
Audits node metadata and connection strings across multiple organizational environments.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsOceanBase
Enterprise distributed relational database. manage clusters, tenants, and databases via AI.
Neon
Manage serverless PostgreSQL databases via Neon. provision projects, branches, endpoints and roles from any AI agent.
Neon (Serverless PostgreSQL)
Manage serverless database infrastructure via Neon. spawn zero-copy branches, audit projects, and monitor compute endpoints.
Xata (Serverless DB)
Manage your serverless databases via Xata. list organizations, manage projects, branches, and execute SQL queries directly from any AI agent.
Nile (PostgreSQL for Multi-Tenant Apps)
Manage tenant-aware databases via Nile. provision B2B tenants, monitor DB metrics, and audit user access.
Aiven
Manage Aiven cloud infrastructure. provision databases, manage projects, and monitor services directly from your AI agent.
Bring your own AI
Change the model, client or framework. Keep PlanetScale connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about PlanetScale.
The practical details behind the request, access and result.
Can I use PlanetScale MCP to manage my MySQL databases?
Yes. This Connector gives your agent the ability to provision, branch, and manage your distributed MySQL clusters using natural language commands.
How does PlanetScale MCP handle database branching?
It allows you to fork your production schema into a new, isolated branch. This is perfect for testing migrations without affecting your live data.
Can my AI agent delete my PlanetScale databases?
Yes, it can use the delete capability to remove a cluster. It is best practice to list your databases first to ensure you are targeting the correct environment.
Does PlanetScale MCP support global regions?
Yes. Your agent can identify all the physical cloud availability zones supported by the backend, helping you choose the best spot for low latency.
Is PlanetScale MCP good for DevOps engineers?
It is excellent for DevOps. It automates the tedious parts of infrastructure management, like purging stale branches and auditing distribution footprints.
How do I provision a new database with PlanetScale MCP?
Just tell your agent to create a new database. It will handle the provisioning of a managed MySQL cluster in your preferred region.
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.
One connection away
Give your agent a direct line to PlanetScale.
Connect PlanetScale once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available