HashiCorp Vault MCP Server for WindsurfGive Windsurf instant access to 50 tools to Approle Login, Configure Aws Root, Configure Database, and more
Windsurf brings agentic AI coding to a purpose-built IDE. Connect HashiCorp Vault through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.
Ask AI about this MCP Server for Windsurf
The HashiCorp Vault MCP Server for Windsurf is a standout in the Fort Knox category — giving your AI agent 50 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
{
"mcpServers": {
"hashicorp-vault": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install HashiCorp Vault and 4,000+ MCP Servers from a single visual interface.





* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About HashiCorp Vault MCP Server
Connect your HashiCorp Vault instance to any AI agent to automate secrets management and security operations through natural language.
Windsurf's Cascade agent chains multiple HashiCorp Vault tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 50 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
What you can do
- Secrets Management — Read, write, and list KV secrets directly from your secure mounts using the KV engine.
- Dynamic Credentials — Generate on-demand credentials for Databases, AWS, and PKI certificates without manual intervention.
- Token Operations — Create, lookup, and renew tokens to manage session lifecycles and access control.
- Transit Encryption — Encrypt and decrypt data using Vault's transit engine to protect sensitive information without exposing keys.
- System Administration — Check cluster health, manage mounts, and configure auth methods or ACL policies directly.
The HashiCorp Vault MCP Server exposes 50 tools through the Vinkius. Connect it to Windsurf in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 50 HashiCorp Vault tools available for Windsurf
When Windsurf connects to HashiCorp Vault through Vinkius, your AI agent gets direct access to every tool listed below — spanning secrets-management, encryption, key-management, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Approle login on HashiCorp Vault
Login using AppRole authentication
Configure aws root on HashiCorp Vault
Configure AWS root credentials
Configure database on HashiCorp Vault
Configure a database connection
Configure kubernetes auth on HashiCorp Vault
Configure Kubernetes authentication
Create acl policy on HashiCorp Vault
Create or update an ACL policy
Create approle role on HashiCorp Vault
Create or update an AppRole role
Create aws role on HashiCorp Vault
Create an AWS role
Create database role on HashiCorp Vault
Create a database role
Create pki role on HashiCorp Vault
Create a PKI role
Create token on HashiCorp Vault
Create a new Vault token
Create transit key on HashiCorp Vault
Create a new Transit key
Create userpass user on HashiCorp Vault
Create a new Userpass user
Decrypt transit on HashiCorp Vault
Decrypt data using Transit engine
Delete kv secret on HashiCorp Vault
Delete the latest version of a KV v2 secret
Enable audit device on HashiCorp Vault
Enable an audit device
Enable auth method on HashiCorp Vault
Enable a new auth method
Enable engine on HashiCorp Vault
Enable a new secrets engine
Encrypt transit on HashiCorp Vault
Encrypt data using Transit engine
Generate approle secret id on HashiCorp Vault
Generate a new Secret ID for an AppRole
Generate aws creds on HashiCorp Vault
Generate dynamic AWS credentials
Generate database creds on HashiCorp Vault
Generate dynamic database credentials
Generate pki root on HashiCorp Vault
Generate a new PKI root certificate
Get init status on HashiCorp Vault
Check Vault initialization status
Get openapi spec on HashiCorp Vault
Generate OpenAPI V3 document of mounted backends
Get system health on HashiCorp Vault
Check Vault system health
Github login on HashiCorp Vault
Login using GitHub personal access token
Initialize vault on HashiCorp Vault
Initialize a new Vault cluster
Issue pki cert on HashiCorp Vault
Issue a new PKI certificate
Kubernetes login on HashiCorp Vault
Login using Kubernetes authentication
List acl policies on HashiCorp Vault
List ACL policies
List audit devices on HashiCorp Vault
List enabled audit devices
List auth methods on HashiCorp Vault
List enabled auth methods
List kv secrets on HashiCorp Vault
List secrets in a KV v2 engine path
List mounts on HashiCorp Vault
List mounted secrets engines
List token accessors on HashiCorp Vault
List token accessors (requires sudo)
Lookup lease on HashiCorp Vault
Lookup a lease by ID
Lookup self token on HashiCorp Vault
Lookup details about the current Vault token
Map github team on HashiCorp Vault
Map a GitHub team to Vault policies
Read kv metadata on HashiCorp Vault
Read metadata for a KV v2 secret
Read kv secret on HashiCorp Vault
Read a secret from KV v2 engine
Renew lease on HashiCorp Vault
Renew a lease
Renew self token on HashiCorp Vault
Renew the current Vault token
Revoke lease on HashiCorp Vault
Revoke a lease
Revoke pki cert on HashiCorp Vault
Revoke a PKI certificate
Revoke self token on HashiCorp Vault
Revoke the current Vault token
Rotate transit key on HashiCorp Vault
Rotate a Transit key
Seal vault on HashiCorp Vault
Seal the Vault
Unseal vault on HashiCorp Vault
Unseal the Vault with a key share
Userpass login on HashiCorp Vault
Login using Username and Password
Write kv secret on HashiCorp Vault
Create or update a secret in KV v2 engine
Connect HashiCorp Vault to Windsurf via MCP
Follow these steps to wire HashiCorp Vault into Windsurf. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Open MCP Settings
Cmd+Shift+P and search "MCP"Add the server
mcp_config.jsonSave and reload
Start using HashiCorp Vault
Why Use Windsurf with the HashiCorp Vault MCP Server
Windsurf provides unique advantages when paired with HashiCorp Vault through the Model Context Protocol.
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 50 tools are immediately available
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
HashiCorp Vault + Windsurf Use Cases
Practical scenarios where Windsurf combined with the HashiCorp Vault MCP Server delivers measurable value.
Automated code generation: ask Cascade to fetch data from HashiCorp Vault and generate models, types, or handlers based on real API responses
Live debugging: query HashiCorp Vault tools mid-session to inspect production data while debugging without leaving the editor
Documentation generation: pull schema information from HashiCorp Vault and have Cascade generate comprehensive API docs automatically
Rapid prototyping: combine HashiCorp Vault data with Cascade's code generation to scaffold entire features in minutes
Example Prompts for HashiCorp Vault in Windsurf
Ready-to-use prompts you can give your Windsurf agent to start working with HashiCorp Vault immediately.
"Check the health and initialization status of my Vault server."
"Read the secret stored at 'secret/data/production/api-keys'."
"Renew my current Vault token for another hour."
Troubleshooting HashiCorp Vault MCP Server with Windsurf
Common issues when connecting HashiCorp Vault to Windsurf through Vinkius, and how to resolve them.
Server not connecting
HashiCorp Vault + Windsurf FAQ
Common questions about integrating HashiCorp Vault MCP Server with Windsurf.
How does Windsurf discover MCP tools?
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?
Does Windsurf support multiple MCP servers?
mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.Explore More MCP Servers
View all →
Nile (PostgreSQL for Multi-Tenant Apps)
6 toolsManage tenant-aware databases via Nile — provision B2B tenants, monitor DB metrics, and audit user access.

Lago
12 toolsManage your metering and usage-based billing with Lago — handle customers, subscriptions, plans, and events directly from your AI agent.

PubNub (Real-time Messaging)
31 toolsEnable real-time messaging, presence tracking, and message history for your AI agent using PubNub's global data stream network.

CoinPaprika API
10 toolsAccess cryptocurrency data — audit coins, markets, and exchanges via AI.
