Resumen
API de Shiprocket para envíos de comercio electrónico en India: pedidos y envíos, viabilidad y tarifas de mensajería, seguimiento por AWB, envío o pedido, NDR, ubicaciones de recogida, canales, productos, inventario, saldo y estado de la billetera, etiquetas y facturas. Creación de pedidos, AWB, recogidas, cancelaciones y acciones NDR instaladas apagadas. Correo electrónico y contraseña del usuario de la API.
Configuración guiada
Conecta Shiprocket a Cursor en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Shiprocket con la configuración guiada y añade tu URL MCP a Cursor. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Shiprocket
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Shiprocket, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Shiprocket + Cursor
API de Shiprocket para envíos de comercio electrónico en India: pedidos y envíos, viabilidad y tarifas de mensajería, seguimiento por AWB, envío o pedido, NDR, ubicaciones de recogida, canales, productos, inventario, saldo y estado de la billetera, etiquetas y facturas. Creación de pedidos, AWB, recogidas, cancelaciones y acciones NDR instaladas apagadas. Correo electrónico y contraseña del usuario de la API.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
SHIPROCKET_EMAIL, SHIPROCKET_PASSWORD
Paso 1 — Obtener credenciales
La configuración tarda unos 3 minutos.
- Inicia sesión en https://app.shiprocket.in y abre Configuración, API, Agregar nuevo usuario de API (Configurar).
- Haz clic en Crear usuario de API, introduce una dirección de correo electrónico que sea diferente de tu inicio de sesión de Shiprocket, elige los módulos a los que el usuario puede acceder y si puede ver los detalles del comprador, luego haz clic en Crear usuario.
- Copia la contraseña del usuario de la API de inmediato (se muestra una sola vez). Pega el correo electrónico del usuario de la API en
SHIPROCKET_EMAILy la contraseña enSHIPROCKET_PASSWORD.
El conector inicia sesión en POST /auth/login y reutiliza el token, que Shiprocket mantiene válido durante 10 días, iniciando sesión nuevamente antes de que expire. Tu inicio de sesión principal no funciona aquí: usa el usuario de la API.
Dónde empezar: shiprocket_list_orders (el más reciente primero), luego shiprocket_get_order para el envío, AWB y mensajero. Seguimiento: shiprocket_track_awb.
Pedidos y envíos: shiprocket_list_orders, shiprocket_get_order, shiprocket_list_shipments, shiprocket_get_shipment. Dos ids son importantes: el id de pedido de Shiprocket (id) utilizado por cada herramienta, y tu propio channel_order_id. Un pedido tiene un envío (shipment_id), que obtiene un AWB cuando se reserva un mensajero.
Tarifas y mensajeros: shiprocket_check_serviceability lista los mensajeros entre dos códigos postales con tarifa, días estimados y calificación; shiprocket_list_couriers tus mensajeros habilitados.
Seguimiento: shiprocket_track_awb, shiprocket_track_awbs (hasta 50), shiprocket_track_shipment, shiprocket_track_order. Paquetes no entregados: shiprocket_list_ndr, shiprocket_get_ndr.
Cuenta: shiprocket_get_wallet_balance, shiprocket_get_statement, shiprocket_list_pickup_locations, shiprocket_list_channels, shiprocket_list_products, shiprocket_get_inventory, shiprocket_get_postcode_details. Documentos: shiprocket_generate_label y shiprocket_generate_invoice responden con un enlace al PDF (gratis, para envíos que ya tienen un AWB).
Envío (instalado apagado): el flujo habitual es shiprocket_create_order, shiprocket_check_serviceability, shiprocket_assign_awb (carga la billetera), shiprocket_request_pickup, luego la etiqueta. shiprocket_cancel_orders, shiprocket_cancel_shipments y shiprocket_ndr_action (un retorno se carga como RTO) también están apagados. Actívalos solo para espacios de trabajo que envían a través de Shiprocket, y confirma cada llamada con el usuario.
Unidades y trampas: peso en kg, tamaños en cm, dinero en INR, los códigos postales tienen 6 dígitos. Las fechas son YYYY-MM-DD; los tiempos en las respuestas son hora de India (IST). Las listas de pedidos están paginadas con page y per_page. Un 422 nombra el campo faltante o incorrecto.
Paso 2 — Instalar el adaptador
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Agregar el conector en Cursor
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de
YOUR_MCP_API_KEY. - Guarda el archivo y reinicia Cursor.
- Abre Cursor → Settings → MCP y comprueba que
anythingmcpaparece en la lista y está conectado. - Empieza a chatear: el agente ya puede usar las herramientas de
Shiprocket.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
shiprocket_list_orders | Lista pedidos, el más reciente primero: id (id de pedido de Shiprocket), channel_order_id (tu id de pedido), channel_name, nombre del cliente, correo electrónico, teléfono y… |
shiprocket_get_order | Lee un pedido por su id de pedido de Shiprocket: detalles del cliente y de facturación, ubicación de recogida, productos (nombre, sku, cantidad, precio), pago… |
shiprocket_list_shipments | Lista envíos: id (id de envío), order_id, channel_order_id, awb, mensajero, estado, fechas de recogida y entrega, peso, dimensiones, cargos.… |
shiprocket_get_shipment | Lee un envío por id de envío: pedido, AWB, mensajero, estado, peso y dimensiones, cargos, fechas de recogida y entrega. Solo lectura |
shiprocket_check_serviceability | Mensajeros que pueden llevar un paquete entre dos códigos postales, con tarifas: por mensajero courier_company_id, courier_name, tarifa (INR) y flete y… |
shiprocket_list_couriers | Los mensajeros de tu cuenta: id de mensajero, nombre, tipo, estado activo y detalles del servicio, con un total. Solo lectura |
shiprocket_track_awb | Sigue un envío por AWB: track_status, shipment_status, current_status (por ejemplo, Entregado, En Tránsito, RTO), courier_name, origen… |
shiprocket_track_awbs | Sigue hasta 50 envíos a la vez por AWB: por AWB los mismos datos de seguimiento que shiprocket_track_awb. Solo lectura |
shiprocket_track_shipment | Sigue un envío por id de envío (los mismos datos que shiprocket_track_awb). Solo lectura |
shiprocket_track_order | Sigue los envíos de un pedido por tu id de pedido de canal, con el id de canal cuando el mismo id de pedido existe en varios canales. Solo lectura |
shiprocket_list_pickup_locations | Tus direcciones de recogida: id, pickup_location (el nombre utilizado en los pedidos), nombre, teléfono, correo electrónico, dirección, ciudad, estado, pin_code, estado y… |
shiprocket_list_ndr | Envíos en NDR (informe de no entrega: el mensajero no pudo entregar): AWB, pedido, cliente, intentos, razón NDR e historial, y la fecha… |
shiprocket_get_ndr | Lee los detalles del NDR de un envío por AWB: intentos, razones, detalles del cliente e historial. Solo lectura |
shiprocket_get_wallet_balance | Tu saldo de billetera de Shiprocket en INR (balance_amount). Los cargos de envío se toman de él. Solo lectura |
shiprocket_get_statement | Tu estado de cuenta: créditos y débitos de billetera por envío o recarga, con fecha, monto, AWB y descripción. Paginado. Solo lectura |
shiprocket_list_channels | Tus canales de venta (personalizados, Shopify, WooCommerce, Amazon...): id, nombre, estado, canal base y configuraciones de sincronización. Solo lectura |
shiprocket_list_products | Productos en tu catálogo de Shiprocket: id, nombre, sku, categoría, precio, peso, dimensiones y HSN. Paginado. Solo lectura |
shiprocket_get_inventory | Inventario por SKU de producto: sku, nombre, cantidad disponible y en mano. Paginado. Solo lectura |
shiprocket_get_postcode_details | Ciudad, estado y país de un código postal indio, y sus localidades. Solo lectura |
shiprocket_generate_label | Genera el PDF de la etiqueta de envío para envíos que ya tienen un AWB: label_url (un enlace al PDF), label_created y los ids de envío… |
shiprocket_generate_invoice | Genera el PDF de la factura para pedidos: invoice_url (un enlace al PDF), is_invoice_created y los ids de pedidos no creados. No cuesta nada |
shiprocket_create_order | Crea un pedido personalizado (adhoc) con su registro de envío. Instalado apagado. El objeto de pedido sigue el modelo de creación/adhoc de Shiprocket… |
shiprocket_assign_awb | Reserva un mensajero para un envío: asigna el AWB y carga el costo de envío a tu billetera. Instalado apagado. Sin courier_id… |
shiprocket_request_pickup | Solicita una recogida de mensajero para un envío que tiene un AWB. El mensajero está programado para el siguiente día hábil o pickup_date. Instalado… |
shiprocket_cancel_orders | Cancela pedidos por id de pedido de Shiprocket. No se puede deshacer; un envío ya recogido no se detiene. Instalado apagado |
shiprocket_cancel_shipments | Cancela envíos por AWB antes de que salgan para recogida (hasta 2000 a la vez). Instalado apagado |
shiprocket_ndr_action | Actúa sobre un envío NDR: reintenta la entrega (opcionalmente con un nuevo teléfono, dirección o fecha) o devuélvelo al origen, lo que se carga como RTO.… |
Ejemplos de indicaciones
- "Sigue el AWB 1234567890123 y dime cuándo será entregado."
- "¿Qué mensajeros pueden entregar un paquete COD de 1.5 kg desde 110001 a 560001, y a qué tarifa?"
- "¿Qué envíos están en NDR en este momento, y por qué?"
- "¿Cuál es mi saldo de billetera de Shiprocket, y qué se cargó esta semana?"
- "Muestra los pedidos de hoy que aún no tienen AWB."
Preguntas frecuentes
¿Qué inicio de sesión utiliza? Un usuario de API que creas en Configuración, API, Agregar nuevo usuario de API, con un correo electrónico que difiere de tu inicio de sesión principal de Shiprocket. Su contraseña se muestra una vez.
¿Qué cubre? Pedidos y envíos, viabilidad y tarifas de mensajería, seguimiento por AWB, envío o pedido, NDR, ubicaciones de recogida, canales, productos, inventario, saldo y estado de la billetera, etiquetas y facturas.
¿Qué herramientas están instaladas apagadas? shiprocket_create_order, shiprocket_assign_awb (carga la billetera), shiprocket_request_pickup, shiprocket_cancel_orders, shiprocket_cancel_shipments y shiprocket_ndr_action. Actívalas en la página del conector solo si la IA debe reservar o cancelar envíos.
¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.
Próximos pasos
¿Te ha sido útil esta guía?