Ejemplos de Código
Copia y pega estos ejemplos para empezar inmediatamente
cURLBuscar Productos
curl -X POST https://agenticmcpstores.com/demo-store/mcp \
-H "Content-Type: application/json" \
-H "X-Agent-Api-Key: YOUR_API_KEY" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_products",
"arguments": {
"query": "laptop",
"limit": 10
}
}
}'PythonCrear Carrito
import requests
response = requests.post(
"https://agenticmcpstores.com/demo-store/mcp",
headers={
"X-Agent-Api-Key": "YOUR_API_KEY",
"Content-Type": "application/json"
},
json={
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "create_cart",
"arguments": {
"merchantId": "demo-store"
}
}
}
)
cart_id = response.json()["result"]["cart_id"]
print(f"Cart created: {cart_id}")TypeScriptObtener Tasas de Envío
const response = await fetch(
"https://agenticmcpstores.com/demo-store/mcp",
{
method: "POST",
headers: {
"X-Agent-Api-Key": "YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
jsonrpc: "2.0",
id: 1,
method: "tools/call",
params: {
name: "get_shipping_rates",
arguments: {
cartId: "cart-123",
address: {
street: "123 Main St",
city: "San Francisco",
country: "US",
postalCode: "94105"
}
}
}
})
}
);
const { result } = await response.json();
console.log(result.rates);cURLSeleccionar Opción de Envío
curl -X POST https://agenticmcpstores.com/demo-store/mcp \
-H "X-Agent-Api-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "select_shipping_option",
"arguments": {
"cartId": "cart-123",
"shippingId": "shipping-456",
"address": {
"street": "123 Main St",
"city": "San Francisco",
"country": "US",
"postalCode": "94105"
}
}
}
}'PythonAplicar Descuento
def apply_discount(cart_id: str, code: str) -> dict:
"""Apply discount code to cart."""
response = requests.post(
"https://agenticmcpstores.com/demo-store/mcp",
headers={
"X-Agent-Api-Key": "YOUR_API_KEY",
"Content-Type": "application/json"
},
json={
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "apply_discount",
"arguments": {
"cartId": cart_id,
"code": code
}
}
}
)
return response.json()["result"]
# Ejemplo: 10% off con TEST123
result = apply_discount("cart-123", "TEST123")
print(f"Discount applied: {result['discountAmount']} off")TypeScriptCompletar Checkout
async function completeCheckout(
cartId: string,
buyerInfo: { name: string; email: string; phone: string }
) {
const response = await fetch(
"https://agenticmcpstores.com/demo-store/mcp",
{
method: "POST",
headers: {
"X-Agent-Api-Key": "YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
jsonrpc: "2.0",
id: 1,
method: "tools/call",
params: {
name: "complete_checkout",
arguments: {
cartId,
buyerInfo
}
}
})
}
);
const { result } = await response.json();
return result.transactionId;
}Referencia Rápida de Tools
| Herramienta | Descripción | Auth Requerida |
|---|---|---|
| search_products | Buscar productos con filtros | Yes |
| get_product_details | Obtener detalles completos del producto | Yes |
| create_cart | Crear carrito de compra | Yes |
| get_shipping_rates | Obtener tasas de envío | Yes |
| select_shipping_option | Seleccionar opción de envío | Yes |
| apply_discount | Aplicar código de descuento | Yes |
| preview_checkout | Previsualizacar checkout | Yes |
| complete_checkout | Completar pago | Yes |