SMKlog Parcel Quotes

Para agentes y desarrolladores

Tarifas de paquetería en vivo, a una sola POST de distancia

El mismo motor que cotiza pedidos en este sitio responde a HTTP simple. Describe un artículo en palabras ordinarias y el tamaño y peso del paquete empaquetado se estiman por ti; proporciona dimensiones exactas para omitir la estimación. USPS, UPS y FedEx en todas partes, DHL Express a Alemania y Australia; sin cuenta, sin clave. Los asistentes pueden llamarlo de forma nativa a través de MCP.

Una sola solicitud

POST https://quote-api.smklog.com/quote
Content-Type: application/json

{"product": "Yamaha FG800 acoustic guitar in a hard case",
 "quantity": 1,
 "from_postal_code": "07102",
 "to_postal_code": "30303"}

La respuesta incluye hasta cinco servicios comprables. Cada tarifa indica tres cifras por separado: amount es el total de pago que paga un cliente, carrier_amount es el costo negociado del transportista debajo de él, y service_fee es la tarifa de SMKlog entre ambos. Cuando un transportista publica un precio minorista de mostrador, retail_amount lo indica. Preferimos darte los tres números en lugar de que descubras el del medio más tarde.

Las dimensiones exactas omiten la estimación: envía length_cm, width_cm, height_cm, weight_kg y package_source: "manual". El contrato completo está en la descripción de OpenAPI 3.1.

Los esquemas, una colección de Postman, un entorno de pruebas en el navegador, los límites de tarifa, una página de estado y todos los documentos de descubrimiento están recopilados en el portal para desarrolladores.

MCP para asistentes

Endpoint HTTP transmisible en https://quote-api.smklog.com/mcp con cinco herramientas. Pulgadas y libras a la entrada, porque así es como la gente describe las cajas. Listado en el registro público de MCP como com.smklog/parcel-shipping-rates.

Tarifas en vivo para un paquete

Describe el artículo en palabras simples y el tamaño y peso del paquete empaquetado se estiman por ti, o proporciona dimensiones exactas para omitir la estimación. Hasta cinco servicios comprables de USPS, UPS, FedEx y DHL Express regresan, cada uno con un total de pago completo junto al costo del transportista.

Toma product, from_zip, to_zip; dimensiones y peso opcionales. Devuelve tarifas en vivo.

Pago, entregado a una persona

Cotiza el envío en vivo y devuelve un enlace que abre la calculadora precargada. La persona confirma los consentimientos de envío y paga en la página de pago alojada: un asistente nunca paga por su cuenta, y esta herramienta nunca cobra nada.

Toma product, from_zip, to_zip; service opcional. Devuelve el monto, una URL de pago y un session_id.

Cómo terminó la transferencia

Dónde está una sesión de pago: enlace creado, pago abierto, pagado, etiqueta comprada con el número de seguimiento, entregado. Se lee del registro del pedido, por lo que no cuesta una llamada al transportista y nunca incluye nombres, direcciones o correos electrónicos. Las sesiones responden durante 30 días.

Toma session_id. Devuelve el estado y, una vez que existe la etiqueta, el número de seguimiento.

Seguimiento de un envío comprado aquí

Estado de entrega actual, los últimos eventos de escaneo y la fecha estimada de entrega cuando el transportista la informa, directamente del registro del envío, sin desvío a un sitio del transportista. Funciona para etiquetas compradas en SMKlog, no como un rastreador universal.

Toma tracking_number. Devuelve el estado y la línea de tiempo de escaneos.

Índice mensual de precios de envío

El índice de precios de envío de paquetes de SMKlog como datos: seis cajas comunes cotizadas a cinco ciudades de EE. UU. a través del mismo pipeline en vivo que cotiza envíos reales. Números de referencia para "cuánto cuesta enviar ahora mismo": leerlos no gasta el límite de cotizaciones.

Toma month opcional (AAAA-MM). Devuelve el servicio más barato por caja y ruta, cada tarifa detrás de él, y el promedio de la canasta.

{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
 "params": {"name": "get_parcel_quote",
            "arguments": {"product": "65 inch flat screen TV in original box",
                          "from_zip": "07102", "to_zip": "90011"}}}

Descubrimiento: tarjeta de servidor, catálogo de API (RFC 9727), índice de habilidades de agentes. En navegadores con soporte WebMCP, las mismas herramientas se registran en las páginas de este sitio a través de navigator.modelContext, por lo que un agente en el navegador puede cotizar y rastrear sin salir de la página. Un envío más allá de los límites de paquete regresa como mode: "not_a_parcel" sin tarifas: SMKlog solo vende etiquetas de paquete y no organiza envíos de pallets o carga.

Conecta tu asistente

Nada que instalar y ninguna clave que solicitar. Apunta cualquier asistente compatible con MCP al endpoint a continuación y pregúntale cuánto cuesta enviar una caja.

Claude Code

Un comando en tu terminal:

claude mcp add --transport http smklog \
  https://quote-api.smklog.com/mcp

Claude Desktop

Configuración → Conectores → Agregar conector personalizado, luego pega la URL del endpoint:

https://quote-api.smklog.com/mcp

Cursor, VS Code, Windsurf

Agrega el servidor a mcp.json (~/.cursor/mcp.json para Cursor, .vscode/mcp.json para VS Code):

{"mcpServers": {
  "smklog": {
    "type": "http",
    "url": "https://quote-api.smklog.com/mcp"
  }
}}

ChatGPT y otros clientes

Agrega un conector MCP personalizado con la misma URL. Sin autenticación: deja el campo de token en blanco.

https://quote-api.smklog.com/mcp

Luego solo pregunta, en palabras simples: "¿Cuánto cuesta enviar un Samsung Crystal UHD TV de 65 pulgadas de 07102 a 90011?" El asistente llama a get_parcel_quote y lee USPS, UPS, FedEx y DHL lado a lado. Pídele que compre la etiqueta y llama a create_checkout_link, que devuelve una página de pago para que tú confirmes y pagues: un agente nunca paga por su cuenta. ¿Prefieres construir tu propio cliente? El endpoint HTTP simple anterior no necesita MCP en absoluto.

Las reglas, claramente

Los límites de tarifa son reales

Por hora, por cliente, y compartidos entre /quote y /mcp, por lo que cambiar de protocolo no agrega capacidad. Cada cotización toca la tarificación en vivo del transportista y nos cuesta dinero: una llamada por envío, caché en tu lado, nunca sondees.

Origen en EE. UU., cinco destinos

El código postal de origen debe ser de EE. UU. Los destinos son EE. UU., Canadá, Reino Unido, Alemania y Australia; cualquier otra cosa regresa sin precio por diseño en lugar de un número incorrecto, y también cualquier cosa que no sea un paquete: SMKlog no organiza carga.

Cotización, no compra

La API responde cuánto cuesta un paquete. Comprar la etiqueta, validación de dirección y revisión de artículos restringidos ocurren en la calculadora.

Preguntas

¿Necesito una cuenta o una clave?

No para uso normal: las sesiones de cotización y pago están abiertas, con límite de tarifa por cliente. Las credenciales existen para un caso: un agente cuyo tráfico legítimo supera los límites públicos obtiene su propio cubo por hora a través de OAuth client_credentials. El registro es manual por ahora: consulta smklog.com/auth.md.

¿Cuánto me cuesta una llamada?

Nada. Nos cuesta a nosotros, sin embargo: cada cotización toca la tarificación en vivo del transportista, así que llama una vez por envío, guarda la respuesta en caché y nunca sondees.

¿Es el precio el precio final del cliente?

El campo amount es el total de pago completo con la tarifa de SMKlog incluida; la tarifa se detalla solo en el recibo de pago. Cuando el transportista publica un precio de mostrador para el mismo paquete, retail_amount lo indica junto al total, para que puedas mostrar a tu usuario cuánto ahorra. Los precios se mueven con las tarifas del transportista, así que una cotización es una instantánea, no un contrato.

¿Puede un agente comprar la etiqueta también?

No de forma autónoma. La herramienta create_checkout_link (intención MPP "session") cotiza el envío y devuelve una URL de transferencia que abre el pago precargado; el humano confirma los consentimientos de envío allí y paga en el pago alojado de Stripe. El agente prepara, la persona paga.

¿Qué pasa con un pallet o una caja?

La respuesta regresa con modo not_a_parcel y sin tarifas. SMKlog solo vende etiquetas de paquete y no organiza envíos de pallets o carga; una caja dentro de los límites de paquete del transportista se cotiza como cualquier otro paquete cuando envías su tamaño y peso medidos.

{"@context":"https://schema.org","@type":"FAQPage","mainEntity":[{"@type":"Question","name":"Do I need an account or a key?","acceptedAnswer":{"@type":"Answer","text":"No for normal use: quoting and payment sessions are open, rate limited per client. Credentials exist for one case — an agent whose legitimate traffic outgrows the public limits gets its own hourly bucket via OAuth client_credentials. Registration is manual for now: see smklog.com/auth.md."}},{"@type":"Question","name":"What does a call cost me?","acceptedAnswer":{"@type":"Answer","text":"Nothing. It costs us, though: every quote hits live carrier rating, so call once per shipment, cache the answer, and never poll."}},{"@type":"Question","name":"Is the price the customer's final price?","acceptedAnswer":{"@type":"Answer","text":"The amount field is the complete checkout total with the SMKlog fee inside; the fee is itemized only on the checkout receipt. Where the carrier publishes a counter price for the same parcel, retail_amount states it beside the total, so you can show your user what they save. Prices move with carrier tariffs, so a quote is a snapshot, not a contract."}},{"@type":"Question","name":"Can an agent buy the label too?","acceptedAnswer":{"@type":"Answer","text":"Not autonomously. The create_checkout_link tool (MPP intent \"session\") prices the shipment and returns a handoff URL that opens the checkout prefilled; the human confirms the shipping consents there and pays on Stripe hosted checkout. The agent prepares, the person pays."}},{"@type":"Question","name":"What happens with a pallet or a crate?","acceptedAnswer":{"@type":"Answer","text":"The response comes back with mode not_a_parcel and no rates. SMKlog sells parcel labels only and does not arrange pallet or freight shipments; a crated box within carrier parcel limits prices like any other parcel when you send its measured size and weight."}}]}

{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://smklog.com/"},{"@type":"ListItem","position":2,"name":"Quote API","item":"https://smklog.com/api"}]}