ipvolt

{
  "name": "ipvolt",
  "url": "https://ipvolt.com/beta/a2a",
  "description": "ipvolt rents dedicated mobile proxies (a device on a carrier network, rented for 1 day or 30 days) that customers pay for from a prepaid USD balance. This agent is deterministic: it uses no language model. Without a credential it lists the live mobile proxy catalog and explains how an AI agent connects to a customer's account. With an agent access token the customer granted, it reads that account's balance, orders and rented proxies, and rents or renews proxies from the balance within the spending cap the customer chose.",
  "version": "1.1.0",
  "documentationUrl": null,
  "iconUrl": null,
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/plain"
  ],
  "skills": [
    {
      "id": "catalog",
      "name": "Mobile proxy catalog",
      "description": "Mobile proxy offers you can rent right now, from the live checkout: country, carrier, period (1 day or 30 days), stock, price in US cents, and the offer id and version that renting needs. Availability changes; read it again before renting. No credential needed.",
      "tags": [
        "mobile proxies",
        "catalog",
        "pricing"
      ],
      "examples": [
        "{\"skill\":\"catalog\"}",
        "{\"skill\":\"catalog\",\"input\":{\"countryCode\":\"GB\",\"period\":\"day\"}}",
        "What mobile proxies can I rent, and at what price?"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "access",
      "name": "Connect an agent to an ipvolt account",
      "description": "How an AI agent gets an access token for a customer's ipvolt account (auth.md, service_auth): register with the customer's email address, the customer signs in and types a 6-digit code, and chooses view only or a spending cap of $10, $25, $50, $100 or $250. Returns the steps and endpoints. No credential needed.",
      "tags": [
        "authentication",
        "auth.md",
        "onboarding"
      ],
      "examples": [
        "{\"skill\":\"access\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "grant",
      "name": "This agent's access",
      "description": "The scopes the customer granted this agent, its spending cap, the amount spent, what remains and when access ends. Needs an agent access token.",
      "tags": [
        "account"
      ],
      "examples": [
        "{\"skill\":\"grant\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "balance",
      "name": "Prepaid balance",
      "description": "Available and held prepaid balance of the customer's account, in US cents. Needs an agent access token with account:read.",
      "tags": [
        "account",
        "balance"
      ],
      "examples": [
        "{\"skill\":\"balance\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "orders",
      "name": "Orders",
      "description": "The customer's latest 100 orders, newest first. Needs an agent access token with account:read.",
      "tags": [
        "account",
        "orders"
      ],
      "examples": [
        "{\"skill\":\"orders\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "proxies",
      "name": "Rented mobile proxies",
      "description": "The customer's rented mobile proxies with their connection details, which are secrets. Needs an agent access token with account:read.",
      "tags": [
        "account",
        "mobile proxies"
      ],
      "examples": [
        "{\"skill\":\"proxies\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "renewal-quote",
      "name": "Renewal quote",
      "description": "A sealed price quote, valid for 2 minutes, to renew one rented proxy for 1 or 30 days. Spends nothing. Input: proxyId and days. Needs an agent access token with proxies:buy.",
      "tags": [
        "mobile proxies",
        "renewal"
      ],
      "examples": [
        "{\"skill\":\"renewal-quote\",\"input\":{\"proxyId\":\"<proxy id from the proxies skill>\",\"days\":30}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "purchase",
      "name": "Rent mobile proxies",
      "description": "Rents mobile proxies from the customer's prepaid balance; the price counts against the spending cap the customer set. Structured input only: intentId (a new UUID; reuse it only to retry the same order), tariffId (the offer id) and offerVersion (the offer version, an integer) from the catalog, and quantity from 1 to 20. A retry never charges twice. Needs an agent access token with proxies:buy.",
      "tags": [
        "mobile proxies",
        "purchase"
      ],
      "examples": [
        "{\"skill\":\"purchase\",\"input\":{\"intentId\":\"<new UUID>\",\"tariffId\":\"<offer id>\",\"quantity\":1,\"offerVersion\":0}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "traffic-purchase",
      "name": "Buy a traffic pack",
      "description": "Buys one prepaid traffic pack from the customer's balance; its price counts against the spending cap the customer set. A pack is GB of proxy traffic on one key that works on residential IPs and on mobile IPs from a shared pool; later packs add GB to the same key and nothing renews. Structured input only: intentId (a new UUID; reuse it only to retry the same order), tariffId (a pack id from the catalog skill's trafficPacks) and offerVersion (that pack's version). One pack per order. The purchase is under ipvolt's Terms and Payments and Refunds Policy. Needs an agent access token with proxies:buy.",
      "tags": [
        "residential proxies",
        "mobile proxies",
        "traffic",
        "purchase"
      ],
      "examples": [
        "{\"skill\":\"traffic-purchase\",\"input\":{\"intentId\":\"<new UUID>\",\"tariffId\":\"<pack id>\",\"offerVersion\":0}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "traffic",
      "name": "Traffic key and locations",
      "description": "The customer's per-GB traffic key: its status, GB bought, used and left, the gateway host and ports, and the countries that have residential and mobile IPs right now. No secret is returned. Needs an agent access token with account:read.",
      "tags": [
        "account",
        "residential proxies",
        "mobile proxies",
        "traffic"
      ],
      "examples": [
        "{\"skill\":\"traffic\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "traffic-connection",
      "name": "Traffic connection line",
      "description": "One ready proxy connection for the customer's traffic key: host, port, username and the key as password, for a network (residential or mobile) and a country. It is a secret. Input: network, country (two letters) and optionally protocol (http or socks5). Needs an agent access token with account:read.",
      "tags": [
        "account",
        "residential proxies",
        "mobile proxies",
        "traffic"
      ],
      "examples": [
        "{\"skill\":\"traffic-connection\",\"input\":{\"network\":\"mobile\",\"country\":\"US\"}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "renew",
      "name": "Renew a rented proxy",
      "description": "Renews a rented proxy from the balance at the price in a renewal quote, within the spending cap. Input: intentId (a new UUID) and quote. Needs an agent access token with proxies:buy.",
      "tags": [
        "mobile proxies",
        "renewal"
      ],
      "examples": [
        "{\"skill\":\"renew\",\"input\":{\"intentId\":\"<new UUID>\",\"quote\":\"<quote from renewal-quote>\"}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extensions": [
      {
        "uri": "https://github.com/google-agentic-commerce/ap2/tree/v0.1",
        "params": {
          "roles": [
            "merchant"
          ]
        },
        "required": false,
        "description": "AP2 v0.1 merchant, paid only from the customer's prepaid USD balance within the spending cap the customer set for the agent. With an agent access token that has proxies:buy, send an IntentMandate whose skus name one offer id from the catalog skill (quantity in an optional \"ipvolt.quantity\" data part). The CartMandate comes back signed with ES256 (keys: https://ipvolt.com/beta/ap2/jwks.json). Pay it with a PaymentMandate in the same message as that CartMandate, with method_name https://ipvolt.com/ap2/prepaid-balance. AP2 here takes no cards or other payment methods."
      }
    ]
  },
  "protocolVersion": "0.3",
  "provider": {
    "organization": "ipvolt",
    "url": "https://ipvolt.com/"
  }
}