Skip to main content
Glama

initiate_agent_purchase

[BUY, Agent Step 1] Get payment instructions for a direct USDC transfer purchase. Use this if you are an AI agent that cannot sign EIP-712 permits.

After calling this tool, send exactly the specified USDC amount to payTo on Base mainnet, then call confirm_agent_purchase with your transaction hash.

PHYSICAL PRODUCTS: the amount includes shipping. Pass the delivery address; if you omit shipping_rate_handle the tool returns the live shipping options (in USDC) for that address instead of payment instructions. Call again with the handle you chose. Pass the same address and handle to confirm_agent_purchase, the server re-quotes them at settlement.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
tokenIdYesThe token ID of the drop to purchase
buyerEmailNoEmail for the order confirmation. Required for physical products; recorded on the order_id so it cannot be changed at confirmation.
buyerWalletYesYour wallet address on Base
selected_sizeNoFor sized products (e.g. sneakers, garments), the size you want to buy (e.g. "10.5", "M"). Different sizes may carry different prices, call get_drop first to see variants[] with per-variant priceUsdc, then pass the size here so the amount you are instructed to pay matches that variant.
shipping_cityNoCity (required for physical products)
shipping_nameNoRecipient name (physical products)
selected_colorNoFor products with a colour axis (e.g. a filtered showerhead in five finishes), the colourway you want to buy. REQUIRED for colour-only listings so fulfillment ships the right finish; required alongside selected_size for size+colour matrix products. Inspect variants[] from get_drop_details to see available colours.
shipping_phoneNoPhone number for the carrier
shipping_stateNoState / province code (required for US, CA, AU)
shipping_countryNoISO 3166-1 alpha-2 country code, e.g. "GB" (required for physical products)
shipping_postal_codeNoPostal / ZIP code (required for physical products)
shipping_rate_handleNoHandle of the shipping option you chose from a previous call. Omit to list the options for the address.
shipping_address_line1NoStreet address line 1 (required for physical products)
shipping_address_line2NoStreet address line 2

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / buyerEmail
      Added value: +{
      +  "description": "Email for the order confirmation. Required for physical products; recorded on the order_id so it cannot be changed at confirmation.",
      +  "format": "email",
      +  "type": "string"
      +}
  2. Changed9 schema fields changed
    • addedInput schema / properties / shipping_address_line1
      Added value: +{
      +  "description": "Street address line 1 (required for physical products)",
      +  "type": "string"
      +}
    • addedInput schema / properties / shipping_address_line2
      Added value: +{
      +  "description": "Street address line 2",
      +  "type": "string"
      +}
    • addedInput schema / properties / shipping_city
      Added value: +{
      +  "description": "City (required for physical products)",
      +  "type": "string"
      +}
    • addedInput schema / properties / shipping_country
      Added value: +{
      +  "description": "ISO 3166-1 alpha-2 country code, e.g. \"GB\" (required for physical products)",
      +  "type": "string"
      +}
    • addedInput schema / properties / shipping_name
      Added value: +{
      +  "description": "Recipient name (physical products)",
      +  "type": "string"
      +}
    • addedInput schema / properties / shipping_phone
      Added value: +{
      +  "description": "Phone number for the carrier",
      +  "type": "string"
      +}
    • addedInput schema / properties / shipping_postal_code
      Added value: +{
      +  "description": "Postal / ZIP code (required for physical products)",
      +  "type": "string"
      +}
    • addedInput schema / properties / shipping_rate_handle
      Added value: +{
      +  "description": "Handle of the shipping option you chose from a previous call. Omit to list the options for the address.",
      +  "type": "string"
      +}
    • addedInput schema / properties / shipping_state
      Added value: +{
      +  "description": "State / province code (required for US, CA, AU)",
      +  "type": "string"
      +}
  3. Changed1 schema field changed
    • changedInput schema / properties / selected_size / description
      Previous value: -"For sized products (e.g. sneakers, garments), the size you want to buy (e.g. \"10.5\", \"M\"). Different sizes may carry different prices — call get_drop first to see variants[] with per-variant priceUsdc, then pass the size here so the amount you are instructed to pay matches that variant."New value: +"For sized products (e.g. sneakers, garments), the size you want to buy (e.g. \"10.5\", \"M\"). Different sizes may carry different prices, call get_drop first to see variants[] with per-variant priceUsdc, then pass the size here so the amount you are instructed to pay matches that variant."
  4. Changed2 schema fields changed
    • addedInput schema / properties / selected_color
      Added value: +{
      +  "description": "For products with a colour axis (e.g. a filtered showerhead in five finishes), the colourway you want to buy. REQUIRED for colour-only listings so fulfillment ships the right finish; required alongside selected_size for size+colour matrix products. Inspect variants[] from get_drop_details to see available colours.",
      +  "type": "string"
      +}
    • changedInput schema / properties / selected_size / description
      Previous value: -"For sized products (e.g. sneakers, garments), the size you want to buy (e.g. \"10.5\", \"M\"). Different sizes may carry different prices — call get_drop first to see variants[] with per-size priceUsdc, then pass the size here so the amount you are instructed to pay matches that size."New value: +"For sized products (e.g. sneakers, garments), the size you want to buy (e.g. \"10.5\", \"M\"). Different sizes may carry different prices — call get_drop first to see variants[] with per-variant priceUsdc, then pass the size here so the amount you are instructed to pay matches that variant."
  5. Changed1 schema field changed
    • addedInput schema / properties / selected_size
      Added value: +{
      +  "description": "For sized products (e.g. sneakers, garments), the size you want to buy (e.g. \"10.5\", \"M\"). Different sizes may carry different prices — call get_drop first to see variants[] with per-size priceUsdc, then pass the size here so the amount you are instructed to pay matches that size.",
      +  "type": "string"
      +}
  6. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources