• DATA
  • LOGISTICS
  • ORDERS
  • HUMAN

How to retrieve customer profiles and addresses with your AI

Connect your AI to VTEX Checkout to access buyer information. Once connected, your agent handles the data fetching and address management.

Ask AI about this page

Short answer

How can I get customer info and addresses using my AI?

Your AI uses a user ID to pull specific client profiles and existing shipping addresses from VTEX. It can also check order states and add new addresses to a profile. You'll see the specific data points it can access below.

Data outcomes

Where the data lands.

The AI moves information between your chat and VTEX based on your requests.

DATA

Client profiles

The AI fetches contact details and profile info. You get the raw data needed for support or personalization.

LOGISTICS

Shipping addresses

Your agent pulls saved addresses or creates new ones. This keeps shipping info accurate without manual entry.

ORDERS

Order status

The AI checks the current state of an order. You'll see exactly where a package is in the fulfillment cycle.

HUMAN

Manual overrides

The AI cannot change core store settings or delete accounts. You stay in control of sensitive administrative changes.

The workflow

What your AI does when a request arrives.

The AI translates your natural language into specific VTEX actions.

  1. Identify the user

    The AI looks up the specific client profile using the provided ID.

    get_client_profile

  2. Check order status

    It pulls the current order form to see recent activity or pending shipments.

    get_orderform

  3. Add new locations

    If a customer needs a new delivery spot, the AI adds it to the system.

    create_address

  4. Verify details

    The AI cross-references the profile and order form to ensure the address is valid.

    get_client_profileget_orderform

Try it

Copy these to start.

Use these prompts to trigger the VTEX Checkout tools.

Starting points

Replace the bracketed info with your actual VTEX user IDs or order numbers.

VTEX Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_1wLH9vAfCGXtiSGXk1obonJ6ckqJcFZi1WL4TSqq/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — VTEX capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "vtex-checkout-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_1wLH9vAfCGXtiSGXk1obonJ6ckqJcFZi1WL4TSqq/mcp"
    }
  }
}
Copy into chat04

  • Get the profile for client ID 12345.

  • What is the current status of order form 98765?

  • Add a new shipping address for this user: 123 Maple St, New York, NY.

  • Show me all saved addresses for the user with ID 5544.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect VTEX Checkout once, then ask.

Just follow the link to connect your account. Your credentials stay encrypted, and you can start asking questions immediately.

Connect VTEX Checkout to your AI

FAQ

How this task behaves.

  • 01

    Can the AI delete a customer profile?

    No. The AI can only retrieve or create data; it cannot delete existing profiles.

  • 02

    Does the AI need a User ID for every request?

    Yes. To pull specific profiles or addresses, the AI needs a valid ID to target the correct account.

  • 03

    Can the AI change a customer's email address?

    No. The current tools allow for retrieving profiles and creating addresses, but not editing existing contact fields.

  • 04

    Can I use this to update order quantities?

    No. The AI can check the order state, but it cannot modify the contents of an order.

  • 05

    How does the AI know which address is the default?

    The AI reads the profile data to identify which address is marked as the primary shipping location.

  • More questions about VTEX Checkout? See everything the VTEX Checkout Connector can do

Connect VTEX to Claude, Cursor, ChatGPT & more