{"uid":"cap__TnzM_xKY74MoqF15dmDt","slug":"tempvpn-node-listing-70d293be","name":"TempVPN Node Listing","description":"Select one returned node and retain its id. Send payment and lifecycle requests to the registry origin.","url":"https://registry.tempvpn.xyz/nodes","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"city":{"type":"string","minLength":1},"region":{"type":"string","minLength":1},"country":{"type":"string","maxLength":2,"minLength":2,"description":"ISO 3166-1 alpha-2 country code."},"available":{"type":"boolean"}}},"responseSchema":{"type":"array","items":{"type":"object","required":["id","name","region","api_url","wireguard_endpoint","expected_exit_ip","lease_expires_at"],"properties":{"id":{"type":"string"},"city":{"type":"string"},"name":{"type":"string"},"region":{"type":"string"},"api_url":{"type":"string","format":"uri","pattern":"^https://","description":"Node API URL exposed for health and latency diagnostics. Clients send payment and lifecycle requests to the registry origin."},"country_code":{"type":"string","maxLength":2,"minLength":2},"available_slots":{"type":"integer","minimum":0},"expected_exit_ip":{"type":"string"},"lease_expires_at":{"type":"string","format":"date-time"},"subdivision_code":{"type":"string"},"accepting_sessions":{"type":"boolean"},"wireguard_endpoint":{"type":"string"}}}},"example":null,"exampleRequest":null,"tags":["networking","privacy","tempo","vpn","wireguard","web"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"1.00","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"healthy","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"TempVPN","brandSlug":"tempvpn-mpp","brandBaseUrl":"https://registry.tempvpn.xyz","brandDocsUrl":"https://registry.tempvpn.xyz/docs","whatItDoes":"Lists available WireGuard VPN nodes worldwide, filterable by country, region, city, and availability.","exampleAgentPrompt":"Find me available TempVPN WireGuard nodes in Germany right now — I need one that's accepting sessions so I can grab its node ID for a new session.","exampleUseCases":[{"title":"Find VPN node by country","prompt":"List all available TempVPN nodes in Japan that are currently accepting sessions — I want to pick one and start a temporary WireGuard session."},{"title":"Browse nodes in specific city","prompt":"Can you find TempVPN WireGuard nodes in London? I want to see what's available so I can choose one with open slots."},{"title":"Discover available nodes for automation","prompt":"Pull the full list of TempVPN nodes that are marked as available right now — I need their IDs and WireGuard endpoints to route some traffic through a US exit IP."}],"resultDescription":"Returns an array of VPN node objects, each containing a unique node ID, human-readable name, region and city, the WireGuard endpoint address, expected exit IP, the node's API URL for health/latency diagnostics, available slot count, whether the node is accepting sessions, lease expiration timestamp, country code, and subdivision code. The agent should retain the node ID for use in subsequent payment and session lifecycle requests sent to the registry origin.","failureModes":["No nodes match the specified filters — returns an empty array","Invalid country code format (not ISO 3166-1 alpha-2) — likely a 422 validation error","All matching nodes have available_slots of 0 or accepting_sessions set to false — no usable results","Service unavailable or registry down — HTTP 5xx error","City or region name misspelled — returns empty results with no error"],"whenToPreferThis":"Use this endpoint when you need to discover and select a WireGuard VPN node before initiating a TempVPN session. It is the required first step in the TempVPN workflow — you must obtain a valid node ID here before sending session creation or payment requests to the registry. Prefer this over any cached node list when freshness matters, as slot availability and lease status change frequently.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-09-02T17:57:09.638Z","lastSuccessfullyRanAt":"2026-09-02T17:57:09.638Z","lastHealthCheckAt":"2026-09-15T18:37:17.768Z","isFirstParty":false}