sap_update_agent

Parameters schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Optional replacement display name. Omit to keep the current name."
    },
    "agentId": {
      "type": "string",
      "description": "Optional replacement stable agent id. Omit to keep current agentId."
    },
    "pricing": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "pricePerCall"
        ],
        "properties": {
          "tierId": {
            "type": "string",
            "description": "Stable tier id, for example default, read, premium, value-action, or enterprise."
          },
          "rateLimit": {
            "type": "number",
            "description": "Maximum calls per second allowed by this tier. Defaults to 60."
          },
          "tokenMint": {
            "type": "string",
            "description": "Optional SPL token mint public key. Required when tokenType is spl. For mainnet USDC use EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v."
          },
          "tokenType": {
            "enum": [
              "sol",
              "usdc",
              "spl"
            ],
            "type": "string",
            "description": "Payment token type. Use usdc for x402/pay.sh agent commerce. Use spl only with tokenMint."
          },
          "burstLimit": {
            "type": "number",
            "description": "Optional short-window burst allowance for this tier."
          },
          "volumeCurve": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "afterCalls",
                "pricePerCall"
              ],
              "properties": {
                "afterCalls": {
                  "type": "number",
                  "description": "Call count threshold where this price starts."
                },
                "pricePerCall": {
                  "type": "string",
                  "description": "Discounted price per call in the smallest unit of tokenType."
                }
              },
              "description": "Volume Curve parameter for Update SAP Agent.",
              "additionalProperties": false
            },
            "description": "Optional volume discounts. Each item lowers pricePerCall after a call threshold."
          },
          "pricePerCall": {
            "type": "string",
            "description": "Price per call in the smallest unit of tokenType: lamports for sol, micro-USDC for usdc, or base units for spl."
          },
          "tokenDecimals": {
            "type": "number",
            "description": "Decimals for the payment token. Defaults to 6 for usdc and 9 for sol when omitted."
          },
          "settlementMode": {
            "enum": [
              "instant",
              "escrow",
              "batched",
              "x402"
            ],
            "type": "string",
            "description": "Settlement strategy. Use x402 for HTTP 402/pay.sh flows, escrow for prepaid SAP usage ledgers, instant for direct pay-per-call, and batched for periodic settlement."
          },
          "maxPricePerCall": {
            "type": "string",
            "description": "Optional ceiling price per call in the smallest unit of tokenType."
          },
          "minPricePerCall": {
            "type": "string",
            "description": "Optional floor price per call in the smallest unit of tokenType."
          },
          "batchIntervalSec": {
            "type": "number",
            "description": "Optional settlement batch interval in seconds when settlementMode is batched."
          },
          "minEscrowDeposit": {
            "type": "string",
            "description": "Optional minimum escrow deposit in the smallest unit of tokenType."
          },
          "maxCallsPerSession": {
            "type": "number",
            "description": "Maximum calls allowed per session for this tier. Defaults to 1000."
          }
        },
        "description": "Pricing parameter for Update SAP Agent.",
        "additionalProperties": false
      },
      "description": "Optional full replacement pricing tier list. Omit to keep current pricing."
    },
    "agentUri": {
      "type": "string",
      "description": "Optional replacement public URI for agent metadata/profile. Use this to update pictures after uploading metadata to IPFS, Arweave, Kommodo, or HTTPS."
    },
    "protocols": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Protocols parameter for Update SAP Agent."
      },
      "description": "Optional full replacement protocol list. Omit to keep current protocols."
    },
    "description": {
      "type": "string",
      "description": "Optional replacement description. Omit to keep the current description."
    },
    "metadataUri": {
      "type": "string",
      "description": "Alias for agentUri. Use a public metadata JSON URI; never use a desktop file path."
    },
    "capabilities": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "string",
            "description": "Capability id shorthand, for example jupiter:swap, pyth:price, metaplex:identity, sns:identity, or risk:management."
          },
          {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "Required stable capability id. Use protocol:action naming, for example jupiter:swap, pyth:price, metaplex:identity, sns:identity, x402:payments, or risk:management."
              },
              "version": {
                "type": "string",
                "description": "Optional capability version string. Use semver when the capability maps to an API contract."
              },
              "protocolId": {
                "type": "string",
                "description": "Optional protocol namespace backing this capability, for example sap, mcp, jupiter, pyth, metaplex, sns, x402, or custom."
              },
              "description": {
                "type": "string",
                "description": "Optional human-readable capability description for agents and explorers."
              }
            },
            "additionalProperties": false
          }
        ],
        "description": "Capabilities parameter for Update SAP Agent."
      },
      "description": "Optional full replacement capability list. Omit to keep current capabilities; do not send only the new item unless replacing the whole list is intended."
    },
    "x402Endpoint": {
      "type": "string",
      "description": "Optional replacement x402 discovery/payment endpoint. Omit to keep current endpoint."
    }
  }
}

No endpoints wrapped at confidence ≥ 0.50.

Parent server