Skip to main content
ME

Melhor Envio

@codespar/mcp-melhor-envio · v0.1.4

🇧🇷 BrazilLogisticsAuth · OAuth2live18 tools2 env vars

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

Get started · freeView docs

MIT · runs locally or through the CodeSpar runtime

Limitations

  • The package manifest does not declare 1 of the 2 variables the code reads.
Package
@codespar/mcp-melhor-envio
Version
0.1.4
npm dist-tag
latest
Category
Logistics
Auth
OAuth2
Country
🇧🇷 Brazil
License
MIT
Transport
stdio · streamable-http

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, or through the hosted runtime.

Add the server to your clientOne config entry. No build step, no SDK required.
Set the environment variables2 variables read by this server's code, listed below.
Restart and make the first callThe agent can call any of the 18 tools. Try calculate_shipping first.
terminal
# Claude Code claude mcp add melhor-envio -e MELHOR_ENVIO_SANDBOX=… -e MELHOR_ENVIO_TOKEN=… -- npx -y @codespar/mcp-melhor-envio@0.1.4 # then: /mcp to confirm the server is connected
Environment variables2 variables
MELHOR_ENVIO_SANDBOXRead by the code; the package manifest does not declare it.
MELHOR_ENVIO_TOKENAPI key for melhor-enviorequiredsecret

Names read from the package code (@codespar/mcp-melhor-envio@0.1.4). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials. On the CodeSpar runtime the credential you connect is stored encrypted (AES-256-GCM, key derived per organization), and the runtime adds it to the provider call itself; the agent never receives it.

First call democalculate_shipping

"Calculate shipping rates from multiple carriers"

tools/callcalculate_shippingresult returned

Tools

What your agent can call.

18 tools, as the package's tools/list returns them.

calculate_shipping

Calculate shipping rates from multiple carriers

create_shipment

Create a shipment order

track_shipment

Track a shipment by order ID

generate_label

Generate shipping label for an order

list_agencies

List carrier pickup agencies near a location

cancel_shipment

Cancel a shipment order

get_balance

Get current account balance

add_cart

Add shipment orders to cart for batch checkout

checkout_cart

Checkout all items in the cart and pay

preview_label

Preview a shipping label before generating

print_label

Print/download label PDF

get_shipment

Get shipment order details by ID

Names and descriptions come from the package's tools/list (@codespar/mcp-melhor-envio@0.1.4). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

Through the CodeSpar runtime, codespar_discover finds this server's tools, and a tools/call runs with the credential connected in your project, a test key included.

hostedhttps://connect.codespar.dev/mcp15 meta-tools

Protocol

Any MCP client

stdio · streamable-http

Questions

Before you install.

How do I install the Melhor Envio MCP server?

Run npx -y @codespar/mcp-melhor-envio@0.1.4 and add the config block above to your MCP client: Claude Code, Cursor, Claude Desktop, VS Code, or any MCP-compatible client. No build step, no SDK required. Prefer hosted? Add the CodeSpar endpoint with a test key and connect Melhor Envio in your project; codespar_discover finds its tools.

What can my agent do with Melhor Envio?

Melhor Envio exposes 18 tools for logistics. Your agent calls them directly; the full list is above.

How does Melhor Envio authenticate, and how are credentials stored?

Melhor Envio uses OAuth2. Self-hosted, you hold the credentials: the server reads them from its environment variables. On the CodeSpar runtime the credential you connect is stored encrypted for your organization, the runtime renews the OAuth2 access token, and it adds the token to each provider call, so the agent never handles it.

How does Melhor Envio handle upstream API changes?

Every server is versioned independently on npm. The command on this page pins 0.1.4, the version whose tools are listed here; your agent keeps running it until you change the version.

Is Melhor Envio open source? How do I report a bug?

Yes. Melhor Envio is MIT-licensed and published on npm as @codespar/mcp-melhor-envio, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Start in seconds.

On the CodeSpar runtime, the credential you connect stays encrypted for your organization and the runtime renews the OAuth2 access token. You just call the tool.

Start in seconds demo
Create an account and copy a test key.
Add the hosted endpoint to your client with the config above.
Connect Melhor Envio in your project and ask your agent for the first call.
Melhor Envio — MCP server · 18 tools | CodeSpar