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

1. Go to StealthSurf dashboard → Profile → API Keys
2. Create a new key (name it anything)
3. 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 configurations
• configs_create — Create a new VPN config
• configs_renew — Renew a config subscription
• configs_get_tariffs — Get available tariffs
• configs_get_available_servers — Get available servers
• configs_get_server_stats — Get server statistics
• configs_update_settings — Update config settings
• configs_update_xray_config — Update custom XRay config
• configs_change_title — Change config title
• configs_toggle_auto_renewal — Toggle auto-renewal
• configs_make_bridge — Create dual-hop bridge
• configs_get_subconfig — Get subconfig (proxy)
• configs_create_subconfig — Create subconfig
• configs_update_subconfig — Update subconfig
• configs_delete_subconfig — Delete subconfig

Cloud Servers (17)

• cloud_servers_list — List cloud servers
• cloud_servers_create_order — Create server order
• cloud_servers_renew — Renew server
• cloud_servers_reboot — Reboot server
• cloud_servers_get_stats — Get server stats
• cloud_servers_toggle_auto_renewal — Toggle auto-renewal
• cloud_configs_list — List configs on server
• cloud_configs_create — Create config on server
• cloud_configs_change_protocol — Change config protocol
• cloud_configs_update_xray — Update XRay config
• cloud_configs_change_title — Change config title
• cloud_configs_delete — Delete config
• cloud_proxies_list — List proxies
• cloud_proxies_create — Create proxy
• cloud_proxies_change_protocol — Change proxy protocol
• cloud_proxies_change_title — Change proxy title
• cloud_proxies_delete — Delete proxy

Paid Options (22)

• paid_options_list — List paid options
• paid_options_create_order — Create/renew paid option
• paid_options_get_tariffs — Get tariffs
• paid_options_get_devices — Get devices
• paid_options_delete_device — Delete device
• paid_options_delete_all_devices — Delete all devices
• paid_options_get_subscription — Get subscription info
• paid_options_update_limits — Update limits
• paid_options_update_title — Update title
• paid_options_delete_title — Reset title
• paid_options_get_stats — Get stats
• paid_options_toggle_auto_renewal — Toggle auto-renewal
• paid_option_configs_get_available_servers — Get servers
• paid_option_configs_create — Create config
• paid_option_configs_get_subconfig — Get subconfig
• paid_option_configs_create_subconfig — Create subconfig
• paid_option_configs_update_subconfig — Update subconfig
• paid_option_configs_delete_subconfig — Delete subconfig
• paid_option_configs_update_settings — Update settings
• paid_option_configs_update_xray — Update XRay
• paid_option_configs_change_title — Change title
• paid_option_configs_get_stats — Get stats

Profile (30)

• profile_get — Get profile info
• profile_get_notification_settings — Get notification settings
• profile_update_notification_settings — Update settings
• profile_regenerate_subscription_link — Regenerate URL
• profile_get_notifications — Get notifications
• profile_connect_telegram — Create Telegram code
• profile_check_telegram — Check Telegram connection
• profile_disconnect_telegram — Disconnect Telegram
• devices_list — List devices
• devices_get_settings — Get device settings
• devices_update_settings — Update device settings
• devices_set_blocked — Block/unblock device
• devices_delete — Delete device
• devices_delete_all — Delete all devices
• balance_calculate — Calculate topup prices
• balance_topup — Topup balance
• referral_get_data — Get referral data
• referral_get_sbp_banks — Get SBP bank list
• referral_withdraw_sbp — Withdraw via SBP
• referral_withdraw_card — Withdraw via card
• payments_history_list — Payment history
• promocodes_list — Purchased promocodes
• custom_subscriptions_list — List subscriptions
• custom_subscriptions_get_available_items — Get items
• custom_subscriptions_create — Create subscription
• custom_subscriptions_get — Get subscription
• custom_subscriptions_update_title — Update title
• custom_subscriptions_update_items — Replace items
• custom_subscriptions_reset_key — Regenerate key
• custom_subscriptions_delete — Delete subscription

Utility (2)

• locations_list — List server locations
• xray_generate_keys — Generate XRay key pair

Docker

docker build -t stealthsurf-mcp .
docker run -p 3000:3000 \
  -e STEALTHSURF_API_URL=https://api.stealthsurf.app \
  stealthsurf-mcp