TrueProxies

com.trueproxies由 trueproxies.com 發布官方發布者v1.0.6更新於 Nov 7, 2026

Plans, services, usage, invoices, endpoints and connection checks for your TrueProxies account

已驗證Streamable HTTP可網頁執行雲端與基礎設施金融

概覽

AI 產生的概覽

以唯讀方式存取 TrueProxies 帳戶:方案、服務、流量、用量歷史、發票、代理端點與連線檢測。

可以做什麼
  • 列出方案、流量包、價格、城市與免費試用狀態
  • 列出並檢視服務狀態、主機、連接埠、能力與限制
  • 查詢已用與剩餘流量、即時速率和用量歷史
  • 列出並取得發票及帳戶資訊
  • 產生代理連線字串並列出服務的 IP 白名單
  • 透過服務送出一次測試請求並回報出口 IP
適用情境
適合讓助理回答代理訂閱相關問題,例如方案價格、剩餘流量、連線失敗原因,或直接產生可用的代理端點連線字串,不必開啟控制台。
執行需求
遠端端點 mcp.trueproxies.com(streamable HTTP),或本機 Docker、Go 安裝。需要 TrueProxies API 金鑰,透過 Authorization Bearer 標頭傳遞(本機執行時為 TRUEPROXIES_API_KEY),並在控制台建立,授予 services:read、billing:read、proxy:read 等權限。list_plans 不需金鑰。
安裝前請注意
每次呼叫都會把 API 金鑰轉送至 api.trueproxies.com,託管端點經 Cloudflare 代理,金鑰與產生的端點都會經過 Cloudflare;若要避免請在本機執行。generate_endpoints 會回傳代理使用者名稱與密碼,僅在需要時授予 proxy:read。check_connection 會消耗流量並啟用尚未使用的免費試用。帳單與發票資訊會暴露給助理。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 TrueProxies,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.trueproxies%2Fmcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "trueproxies": {
      "type": "http",
      "url": "https://mcp.trueproxies.com/mcp"
    }
  }
}

README

TrueProxies MCP server

Connect Claude, Cursor or any MCP client to your TrueProxies account. Ask about plans and prices, your services, traffic used, live traffic, usage history and invoices, generate endpoints and check a connection.

The server cannot buy, pay, change your proxy password or change the IP whitelist. Every tool only reads, except check_connection, which sends one request through your service.

Tools

ToolWhat it returnsAPI key scope
list_plansPlans, traffic packs, prices, cities, free trial availabilitynone
get_accountYour accountservices:read
list_servicesYour servicesservices:read
get_serviceOne service: hosts, ports, capabilities, limitsservices:read
get_traffic_usedTraffic used and remainingservices:read
get_live_trafficLive download and upload speed, traffic used todayservices:read
get_usage_historyConnection success, traffic and connection errors over 24h, 7d or 30dservices:read
list_invoicesYour invoicesbilling:read
get_invoiceOne invoicebilling:read
generate_endpointsProxy connection lines, including the username and passwordproxy:read
check_connectionThe result and exit IP of one request through your service. It uses a little traffic and starts an unused free trial.proxy:read
list_trusted_ipsThe IP whitelist of a serviceproxy:read

API key

Create an API key in the TrueProxies dashboard under API. For read-only use, give it services:read and billing:read. Add proxy:read only if the assistant should generate endpoints, check connections or list whitelisted IPs: endpoints contain your proxy password.

Connect

Hosted (nothing to install):

bash
claude mcp add --transport http trueproxies https://mcp.trueproxies.com/mcp \  --header "Authorization: Bearer $TRUEPROXIES_API_KEY"

Cursor (~/.cursor/mcp.json):

json
{  "mcpServers": {    "trueproxies": {      "url": "https://mcp.trueproxies.com/mcp",      "headers": { "Authorization": "Bearer ${env:TRUEPROXIES_API_KEY}" }    }  }}

Local, with Docker. Build the image once:

bash
docker build -t trueproxies-mcp https://github.com/trueproxies-com/trueproxies-mcp.git
json
{  "mcpServers": {    "trueproxies": {      "command": "docker",      "args": ["run", "-i", "--rm", "-e", "TRUEPROXIES_API_KEY", "trueproxies-mcp"],      "env": { "TRUEPROXIES_API_KEY": "tp_api_..." }    }  }}

Local, with Go: go install github.com/trueproxies-com/trueproxies-mcp@latest, then run trueproxies-mcp stdio with TRUEPROXIES_API_KEY set.

Privacy

The hosted server forwards your API key to api.trueproxies.com for each call and keeps nothing. It logs the tool name, status, request ID and duration, never arguments, results or keys. mcp.trueproxies.com is served through Cloudflare, which decrypts traffic in transit like any Cloudflare-proxied site, so your API key and any endpoints pass through Cloudflare. To avoid that, run the server locally.

Links

License

MIT

來源:README.md,提交 6c707fa

工具

12

check_connection

Check connection

Sends one request through the service from TrueProxies and reports the outcome and exit IP, to tell a proxy problem apart from a website refusing you. It counts as use of the service: it uses a little traffic and starts an unused free trial. Does not measure speed. Limited to a few checks a minute.

輸入參數asncityregioncountrysessionlifetimeprotocolservice_id必填

generate_endpoints

Generate endpoints

Builds proxy connection lines for a service with the chosen protocol, format, location targeting and session type: one line, or up to 50,000 sticky sessions with session sticky. Does not change the service. The output contains the proxy username and password, which let anyone who has them use the service.

輸入參數asncitycountformatregioncountrysessionlifetimeprotocolservice_id必填

get_account

Get your account

Returns the TrueProxies account that owns the API key: account reference, email, role, status and billing details.

無需輸入參數。

get_invoice

Get an invoice

Returns one invoice: status, amounts in cents, payment attempts and its service. Does not start a payment.

輸入參數invoice_id必填

get_live_traffic

Get live traffic

Returns live traffic for one service: download and upload speed in bits per second over the last ten seconds, traffic used today (UTC) and recent connection outcomes. last_activity_at shows how fresh the data is.

輸入參數service_id必填

get_service

Get a service

Returns one service: status, expiry, connection hosts and ports, capabilities (the targeting and session options it supports) and effective limits. Does not return the proxy password.

輸入參數service_id必填

get_traffic_used

Get traffic used and remaining

Returns traffic for one service, in bytes: bytes_out is downloaded and bytes_in is uploaded since the service started, remaining_bytes is traffic remaining and allowance_bytes is the allowance. traffic_batches lists traffic packs; traffic bought now never expires, and only older packs carry an expiry. Traffic can take about a minute to appear.

輸入參數service_id必填

get_usage_history

Get usage history

Returns usage history for one service, or for the whole account when service_id is empty: connection success, traffic and connection errors over the last 24h, 7d or 30d. In series, bytes_out is downloaded and bytes_in is uploaded. Can lag recent traffic.

輸入參數rangeservice_id

list_invoices

List invoices

Lists invoices with status (open, paid or cancelled), kind, amount in cents and the service each belongs to. Paginated: pass next_cursor from the previous response as cursor.

輸入參數kindlimitcursorstatusservice_id

list_plans

List plans and prices

Lists TrueProxies plans and traffic packs: price in US cents, term, speed, connection limits, traffic allowance and targeting capabilities. Also returns the cities available for city targeting and whether the free trial is open. Traffic packs (residential_ipv4_gb, residential_ipv4_premium, residential_ipv4_lite) have no term, and their traffic never expires. Static ISP (isp_dedicated) is priced per IP for each carrier, named in display_name. No API key needed.

輸入參數termproduct

list_services

List your services

Lists the services on the account with status, product, plan, expiry and connection hosts. Paginated: pass next_cursor from the previous response as cursor.

輸入參數viewlimitcursor

list_trusted_ips

List whitelisted IPs

Lists the IP whitelist of a service: addresses allowed to connect without the proxy password.

輸入參數service_id必填

版本歷史

5
  1. v1.0.6最新Nov 7, 2026
  2. v1.0.5Nov 3, 2026
  3. v1.0.4Oct 21, 2026
  4. v1.0.3Sep 29, 2026
  5. v1.0.2Sep 29, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分