SMKlog Parcel Quotes

Para agentes e desenvolvedores

Tarifas de encomendas em tempo real, a um POST de distância

O mesmo mecanismo que precifica pedidos neste site responde a HTTP simples. Descreva um item em palavras comuns e o tamanho e o peso da caixa embalada são estimados para você; forneça dimensões exatas para pular a estimativa. USPS, UPS e FedEx em qualquer lugar, DHL Express para Alemanha e Austrália; sem conta, sem chave. Assistentes podem chamá-lo nativamente via MCP.

Uma única requisição

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"}

A resposta traz até cinco serviços compráveis. Cada tarifa informa três valores separadamente: amount é o total no checkout que o cliente paga, carrier_amount é o custo negociado da transportadora abaixo dele, e service_fee é a taxa SMKlog entre os dois. Quando uma transportadora publica um preço de balcão, retail_amount o carrega. Preferimos entregar todos os três números a fazer você descobrir o do meio depois.

Dimensões exatas pulam a estimativa: envie length_cm, width_cm, height_cm, weight_kg e package_source: "manual". O contrato completo está na descrição OpenAPI 3.1.

Schemas, uma coleção Postman, um playground de navegador, os limites de taxa, uma página de status e todos os documentos de descoberta estão reunidos no portal do desenvolvedor.

MCP para assistentes

Endpoint HTTP streamable em https://quote-api.smklog.com/mcp com cinco ferramentas. Polegadas e libras na entrada, porque é assim que as pessoas descrevem caixas. Listado no registro público de MCP como com.smklog/parcel-shipping-rates.

Tarifas em tempo real para uma encomenda

Descreva o item em palavras simples e o tamanho e o peso da caixa embalada são estimados para você — ou forneça dimensões exatas para pular a estimativa. Até cinco serviços compráveis USPS, UPS, FedEx e DHL Express retornam, cada um com um total completo de checkout e o custo da transportadora ao lado.

Recebe product, from_zip, to_zip; dimensões e peso opcionais. Retorna tarifas em tempo real.

Checkout, entregue a uma pessoa

Precifica o envio em tempo real e retorna um link que abre a calculadora pré-preenchida. A pessoa confirma os consentimentos de envio e paga na página de checkout hospedada — um assistente nunca paga por conta própria, e esta ferramenta nunca cobra nada.

Recebe product, from_zip, to_zip; service opcional. Retorna o valor, uma URL de checkout e um session_id.

Como a transferência terminou

Onde uma sessão de checkout está: link criado, checkout aberto, pago, etiqueta comprada com o número de rastreio, entregue. Lido do registro do pedido, então não custa nenhuma chamada à transportadora e nunca carrega nomes, endereços ou e-mails. Sessões respondem por 30 dias.

Recebe session_id. Retorna o status e, uma vez que a etiqueta exista, o número de rastreio.

Acompanhe um envio comprado aqui

Status de entrega atual, os eventos de leitura mais recentes e a data de entrega estimada quando a transportadora informa uma — direto do registro do envio, sem desvio para o site da transportadora. Funciona para etiquetas compradas na SMKlog, não como um rastreador universal.

Recebe tracking_number. Retorna o status e a linha do tempo de leituras.

Índice mensal de preços de envio

O índice de preços de envio de encomendas SMKlog como dados: seis caixas do dia a dia precificadas para cinco cidades dos EUA pelo mesmo pipeline ao vivo que precifica envios reais. Números de referência para "quanto custa enviar agora" — lê-los não gasta cota de cotações.

Recebe month opcional (AAAA-MM). Retorna o serviço mais barato por caixa e rota, todas as tarifas por trás dele, e a média da cesta.

{"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"}}}

Descoberta: cartão do servidor, catálogo de API (RFC 9727), índice de habilidades de agentes. Em navegadores com suporte a WebMCP, as mesmas ferramentas se registram nas páginas deste site via navigator.modelContext, então um agente no navegador pode precificar e rastrear sem sair da página. Um envio além dos limites de encomenda retorna como mode: "not_a_parcel" sem tarifas: a SMKlog vende apenas etiquetas de encomenda e não organiza envios de paletes ou carga fracionada.

Conecte seu assistente

Nada para instalar e nenhuma chave para solicitar. Aponte qualquer assistente compatível com MCP para o endpoint abaixo e pergunte quanto custa enviar uma caixa.

Claude Code

Um comando no seu terminal:

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

Claude Desktop

Configurações → Conectores → Adicionar conector personalizado, depois cole a URL do endpoint:

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

Cursor, VS Code, Windsurf

Adicione o servidor ao 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 e outros clientes

Adicione um conector MCP personalizado com a mesma URL. Sem autenticação: deixe o campo de token em branco.

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

Depois é só perguntar, em palavras simples: "Quanto custa enviar uma TV Samsung Crystal UHD de 65 polegadas de 07102 para 90011?" O assistente chama get_parcel_quote e lê de volta USPS, UPS, FedEx e DHL lado a lado. Peça para comprar a etiqueta e ele chama create_checkout_link, que retorna uma página de checkout para você confirmar e pagar — um agente nunca paga por conta própria. Prefere construir seu próprio cliente? O endpoint HTTP simples acima não precisa de MCP.

As regras, claramente

Limites de taxa são reais

Por hora, por cliente, e compartilhados entre /quote e /mcp, então trocar de protocolo não adiciona capacidade. Cada cotação atinge a classificação ao vivo da transportadora e nos custa dinheiro: uma chamada por envio, cache do seu lado, nunca faça polling.

Origem nos EUA, cinco destinos

O CEP de origem deve ser dos EUA. Destinos são EUA, Canadá, Reino Unido, Alemanha e Austrália; qualquer outra coisa retorna sem preço por design, em vez de um número errado, e o mesmo vale para qualquer coisa que não seja uma encomenda: a SMKlog não organiza carga fracionada.

Precificação, não compra

A API responde quanto custa uma encomenda. Comprar a etiqueta, validação de endereço e triagem de itens restritos acontecem na calculadora.

Perguntas

Preciso de uma conta ou chave?

Não para uso normal: cotações e sessões de pagamento são abertas, com limite de taxa por cliente. Credenciais existem para um caso — um agente cujo tráfego legítimo ultrapassa os limites públicos ganha seu próprio balde por hora via OAuth client_credentials. O registro é manual por enquanto: veja smklog.com/auth.md.

Quanto custa uma chamada para mim?

Nada. Custa para nós, no entanto: cada cotação atinge a classificação ao vivo da transportadora, então chame uma vez por envio, faça cache da resposta e nunca faça polling.

O preço é o preço final do cliente?

O campo amount é o total completo do checkout com a taxa SMKlog incluída; a taxa é detalhada apenas no recibo do checkout. Quando a transportadora publica um preço de balcão para a mesma encomenda, retail_amount o informa ao lado do total, para você mostrar ao seu usuário o que ele economiza. Os preços mudam com as tarifas das transportadoras, então uma cotação é um instantâneo, não um contrato.

Um agente também pode comprar a etiqueta?

Não de forma autônoma. A ferramenta create_checkout_link (intenção MPP "session") precifica o envio e retorna uma URL de transferência que abre o checkout pré-preenchido; o humano confirma os consentimentos de envio lá e paga no checkout hospedado da Stripe. O agente prepara, a pessoa paga.

O que acontece com um palete ou um engradado?

A resposta retorna com mode not_a_parcel e sem tarifas. A SMKlog vende apenas etiquetas de encomenda e não organiza envios de paletes ou carga fracionada; uma caixa engradada dentro dos limites de encomenda da transportadora é precificada como qualquer outra encomenda quando você envia o tamanho e o 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"}]}