← Back to blog

Set Up the XBuyer MCP Server for Your AI Agent in 5 Minutes

By XBuyer DevRel · Updated August 2026

This is the hands-on version. If you’d rather start with the why, read the Complete Guide first. Here we connect an agent to XBuyer and place one authorized order.

Step 1: Read the agent card
The agent card at /agents describes XBuyer’s capabilities in machine-readable form — what the agent can ask (catalog search, stock, price, order) and how. Point your MCP client at the endpoint declared there. No API key is needed to browse; keys only enter the picture when the agent spends.
Step 2: Connect, don't log in
The agent authenticates via the MCP server, not by holding your account password. This keeps the boundary clean: the agent can shop the catalog but can’t reconfigure your account. The security model is detailed in How to Let Your AI Agent Spend Safely.
Step 3: Fund the agent wallet
Before any purchase, allocate funds to the agent’s isolated wallet. Zero balance means zero ability to buy — the safest default. The wallet is separate from your main balance, so an agent can never reach funds you didn’t explicitly give it.
Step 4: Scope the agent
Narrow the agent to what it should do. A good first scope is one category (e.g. Home) and a max price. Per-item authorization means every checkout is re-checked server-side anyway, but scoping keeps the agent’s behavior predictable for you.
Step 5: Place the first order
Ask the agent to “find a <item> under <price> that ships to my country and order it.” XBuyer recomputes the price server-side, checks the wallet atomically, and only then reserves the item and triggers fulfillment. You’ll see the order in your history immediately.

If something feels off

Revoke the agent from your dashboard — access ends on the next request, no token expiry window. Then redeploy with a tighter scope. Trying agentic commerce is low-risk by design. The developer docs cover the full request/response shapes for building your own client.

Next

Once it’s working, the interesting part is what agents do with a spend-controlled channel — see Agentic Commerce vs Traditional Dropship Sites for where this model pulls ahead.