Add it to Claude Code
claude mcp add --transport http -H "Authorization: Bearer stlth_your_api_key_here" stealthsurf https://mcp.stealthsurf.appMake your agent remember this setup
stealthsurf's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Manage VPN configurations and subconfigs
- Provision and manage cloud server orders
- Monitor server statistics and performance
- Automate subscription renewals and account settings
- Perform device security audits
Tools 5
configs_listList VPN configurationsconfigs_createCreate a new VPN configcloud_servers_listList cloud serverscloud_servers_create_orderCreate server orderpaid_options_listList paid optionsEnvironment Variables
STEALTHSURF_API_URLAPI base URLPORTHTTP server portTry it
Original README from StealthSurf-VPN/mcp
StealthSurf MCP Server
MCP (Model Context Protocol) server for StealthSurf VPN API. Allows AI agents (Claude Desktop, Cursor, etc.) to manage VPN configs, cloud servers, paid options, and more through natural language.
Architecture
Thin stateless proxy: MCP tool calls → HTTP requests to StealthSurf API.
MCP Client (Claude Desktop / Cursor)
│ POST / (Authorization: Bearer stlth_...)
▼
StealthSurf MCP Server (this service)
│ HTTP (Authorization: Bearer stlth_...)
▼
StealthSurf API
Setup
# Install dependencies
yarn install
# Development
yarn dev
# Production
yarn build && yarn start
Environment Variables
| Variable | Default | Description |
|---|---|---|
STEALTHSURF_API_URL |
https://api.stealthsurf.app |
API base URL |
PORT |
4500 |
HTTP server port |
MCP Client Configuration
Claude Desktop
Add to ~/.claude/settings.json:
{
"mcpServers": {
"stealthsurf": {
"url": "https://mcp.stealthsurf.app",
"headers": {
"Authorization": "Bearer stlth_your_api_key_here"
}
}
}
}
Getting an API Key
- Go to StealthSurf dashboard → Profile → API Keys
- Create a new key (name it anything)
- Copy the
stlth_*key (shown only once)
Resources (4)
Reference data accessible without API calls.
| URI | Description |
|---|---|
stealthsurf://guide |
Full StealthSurf documentation |
stealthsurf://updates |
Latest updates and changelog |
stealthsurf://errors |
API error codes reference |
stealthsurf://protocols |
VPN protocol comparison and compatibility matrix |
Prompts (11)
Workflow templates that guide AI agents through multi-step scenarios.
| Prompt | Description |
|---|---|
setup-vpn |
Interactive VPN config creation wizard |
troubleshoot |
Step-by-step connection issue diagnostics |
optimize-for-region |
Protocol recommendations by region |
account-overview |
Full account status report |
bulk-renew |
Batch renewal of expiring configs |
setup-family |
Custom subscription for sharing |
setup-cloud-server |
Full VPS setup wizard |
switch-protocol |
Bulk protocol migration |
setup-bridge |
Dual-hop bridge creation |
device-audit |
Device security audit |
xray-config |
Custom XRay configuration guide |
Available Tools (92)
VPN Configs (15)
configs_list— List VPN configurationsconfigs_create— Create a new VPN configconfigs_renew— Renew a config subscriptionconfigs_get_tariffs— Get available tariffsconfigs_get_available_servers— Get available serversconfigs_get_server_stats— Get server statisticsconfigs_update_settings— Update config settingsconfigs_update_xray_config— Update custom XRay configconfigs_change_title— Change config titleconfigs_toggle_auto_renewal— Toggle auto-renewalconfigs_make_bridge— Create dual-hop bridgeconfigs_get_subconfig— Get subconfig (proxy)configs_create_subconfig— Create subconfigconfigs_update_subconfig— Update subconfigconfigs_delete_subconfig— Delete subconfig
Cloud Servers (17)
cloud_servers_list— List cloud serverscloud_servers_create_order— Create server ordercloud_servers_renew— Renew servercloud_servers_reboot— Reboot servercloud_servers_get_stats— Get server statscloud_servers_toggle_auto_renewal— Toggle auto-renewalcloud_configs_list— List configs on servercloud_configs_create— Create config on servercloud_configs_change_protocol— Change config protocolcloud_configs_update_xray— Update XRay configcloud_configs_change_title— Change config titlecloud_configs_delete— Delete configcloud_proxies_list— List proxiescloud_proxies_create— Create proxycloud_proxies_change_protocol— Change proxy protocolcloud_proxies_change_title— Change proxy titlecloud_proxies_delete— Delete proxy
Paid Options (22)
paid_options_list— List paid optionspaid_options_create_order— Create/renew paid optionpaid_options_get_tariffs— Get tariffspaid_options_get_devices— Get devicespaid_options_delete_device— Delete devicepaid_options_delete_all_devices— Delete all devicespaid_options_get_subscription— Get subscription infopaid_options_update_limits— Update limitspaid_options_update_title— Update titlepaid_options_delete_title— Reset titlepaid_options_get_stats— Get statspaid_options_toggle_auto_renewal— Toggle auto-renewalpaid_option_configs_get_available_servers— Get serverspaid_option_configs_create— Create configpaid_option_configs_get_subconfig— Get subconfigpaid_option_configs_create_subconfig— Create subconfigpaid_option_configs_update_subconfig— Update subconfigpaid_option_configs_delete_subconfig— Delete subconfig- `paid_option_co