Melhor Envio

v0.1.2OAuth2

Multi-carrier shipping: quote Correios, Jadlog, Loggi, and 10+ carriers. Generate labels, track packages, and manage agencies.

18 tools1 env vars🇧🇷 Brazilstable on npm

Install

terminal

$ npm install @codespar/mcp-melhor-envio

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "melhor-envio": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-melhor-envio"
      ],
      "env": {
        "MELHOR_ENVIO_TOKEN": "<your_melhor_envio_token>"
      }
    }
  }
}

After restart, your agent can call any of the 18 tools below — try calculate_shipping first.

Environment variables · 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

MELHOR_ENVIO_TOKEN

requiredsecret

API key for melhor-envio

Available tools · 18

Each tool is independent — your agent loads only what it needs to reduce context and response time.

READcalculate_shipping

Calculate shipping rates from multiple carriers

WRITEcreate_shipment

Create a shipment order

WRITEtrack_shipment

Track a shipment by order ID

WRITEgenerate_label

Generate shipping label for an order

READlist_agencies

List carrier pickup agencies near a location

DELETEcancel_shipment

Cancel a shipment order

READget_balance

Get current account balance

WRITEadd_cart

Add shipment orders to cart for batch checkout

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.