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 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

MCP Servers