ELH VPN Cloud

io.github.myappleknightPublished by GitHub account myappleknightv0.8.0Updated Nov 15, 2026

Let AI agents open short-lived, capped HTTPS proxy sessions on a member's own prepaid VPN data.

VerifiedStreamable HTTPWeb executableCloud & InfrastructureSecurity & Monitoring

Overview

AI-generated overview

Lets an AI agent open short-lived, capped HTTPS proxy sessions on a member's prepaid ELH VPN data, plus check plans, regions and session status.

What you can do
  • List prepaid data packs, prices and the daily free allowance, and list available server regions
  • Start, inspect, refresh credentials for and stop a short-lived HTTPS CONNECT proxy session
  • Retrieve the member's referral invite link and reward rules
  • Purchases and account management are not available to the agent
When to use it
Useful when an agent needs to route web requests through a VPN proxy under a member's own prepaid data, with per-session time and data caps, or when you want to check plans and regions before signing up.
Requirements
Remote Streamable HTTP endpoint; no local package. A free member account at the provider's site, and an agent key starting with elh_ak_ (created in the member center, shown once, up to 3 keys) sent as an Authorization Bearer header. get_plans and get_regions work without a key.
Before you install
The agent key is a secret: keep it in an environment variable or secret store and never commit it. Sessions spend the member's own prepaid data, and starting a session ends the member's other active connection. The key cannot buy or manage the account, and purchases happen only on the website. Terms forbid illegal use, mass scraping, CAPTCHA bypassing and circumventing access controls.

Installation

In SourceWeft

  1. Open ELH VPN Cloud in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.myappleknight%2Felh-vpn-cloud/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "elh-vpn-cloud": {
      "type": "http",
      "url": "https://vpn.easylifehub.net/wp-json/elh-vpn/v1/mcp"
    }
  }
}

README

ELH VPN Cloud — MCP server & Agent API

繁體中文

ELH VPN Cloud is a prepaid, no-auto-renewal VPN (WireGuard, Android app; browser extension coming). Members get a small free allowance every day. This repo shows how AI agents can use it safely through a hosted MCP server and a small REST API.

An agent can open a short-lived, capped HTTPS proxy session on behalf of a member, charged to that member's own prepaid data. The member stays in control: they create the agent key, set its time/data limits, and can revoke it at any time.

  • Website: https://vpn.easylifehub.net
  • MCP endpoint (Streamable HTTP, stateless): https://vpn.easylifehub.net/wp-json/elh-vpn/v1/mcp
  • OpenAPI: https://vpn.easylifehub.net/wp-json/elh-vpn/v1/agent/openapi
  • For LLMs: https://vpn.easylifehub.net/llms.txt

Tools

ToolKey neededWhat it does
get_plansnoPrepaid packs (data, validity, TWD/USD price) and the daily free allowance
get_regionsnoAvailable server regions
start_sessionyesStart a capped HTTPS CONNECT proxy session; returns host, port and a 15-minute credential
get_sessionyesStatus, remaining time, data used
refresh_credentialyesNew 15-minute credential for an active session
stop_sessionyesStop immediately
get_referral_linkyesThe member's invite link and reward rules

Purchases are never made by agents — only by the member on the website.

Setup

  1. Sign up at https://vpn.easylifehub.net/member/ (free daily allowance, no credit card).
  2. Create an agent key (starts with elh_ak_), choosing its max minutes and max MB per session. Up to 3 keys; the key is shown only once.
  3. Add the MCP server to your client:

Cursor / clients with native remote MCP — examples/cursor-mcp.json

json
{  "mcpServers": {    "elh-vpn": {      "url": "https://vpn.easylifehub.net/wp-json/elh-vpn/v1/mcp",      "headers": { "Authorization": "Bearer ${env:ELH_AGENT_KEY}" }    }  }}

Claude Desktop (via mcp-remote) — examples/claude-desktop-config.json

Plain HTTP — examples/quickstart.sh, or the Python example examples/use_proxy.py that starts a session, fetches one page through the proxy and stops.

bash
curl -s -X POST https://vpn.easylifehub.net/wp-json/elh-vpn/v1/mcp \  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_plans","arguments":{}}}'

Safety & rules

  • Keep the agent key secret (env var / secret store). Never commit it.
  • Sessions stop automatically at the key's time or data limit, or when the account runs out of data.
  • Starting a session ends the member's other active connection.
  • Don't use the service for anything illegal, for spam, or for abuse of third-party sites. See the Terms.

Referral program (single-level)

A member's invite link gives the member a 2 GB pack for every paid order by an invited friend (no limit), and the friend gets 2 GB on their first paid order. Rewards are released 7 days after payment if not refunded. Share the link only when genuinely recommending the service — never spam.

License

Examples in this repo: MIT. The ELH VPN Cloud service itself is proprietary.

Source: README.md at commit f11ecf8

Tools

7

get_plans

Get plans and prices

List the prepaid packs (data, validity, TWD and USD prices) and the daily free allowance. No key needed. Purchases happen only on the website with the member's consent.

Takes no parameters.

get_regions

Get server regions

List available server regions (country code, city, IP type). No key needed.

Takes no parameters.

start_session

Start a proxy session

Start a short-lived HTTPS (TLS) CONNECT proxy session for the member who owns the agent key. Returns proxy host, port and a 15-minute credential. Usage is charged to the member's own data. Ends the member's other active connection.

Parametersmax_mbregionmax_minutes

get_session

Get session status

Status, remaining time and data used for a session.

Parameterssession_idrequired

refresh_credential

Refresh proxy credential

Get a fresh 15-minute proxy credential for an active session.

Parameterssession_idrequired

stop_session

Stop session

Stop the session immediately.

Parameterssession_idrequired

Version history

1
  1. v0.8.0LatestNov 15, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts