mcp-melhor-envio

@codespar/mcp-melhor-envio

MCP server for Melhor Envio — shipping aggregator with multi-carrier rate comparison

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "melhor-envio": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-melhor-envio"],
      "env": {
        "MELHOR_ENVIO_TOKEN": "your-token",
        "MELHOR_ENVIO_SANDBOX": "true"
      }
    }
  }
}

Claude Code

claude mcp add melhor-envio -- npx @codespar/mcp-melhor-envio

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "servers": {
    "melhor-envio": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-melhor-envio"],
      "env": {
        "MELHOR_ENVIO_TOKEN": "your-token",
        "MELHOR_ENVIO_SANDBOX": "true"
      }
    }
  }
}

Tools (18)

Tool	Purpose
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
list_shipments	List all shipment orders with filters
get_store	Get store/company information
search_agencies	Search pickup agencies by service and location
create_address	Create a stored address for sender/recipient
list_services_available	List available shipping services for a route
get_tracking_history	Get complete tracking history with events

Authentication

Melhor Envio uses a Bearer token for authentication.

Sandbox / Testing

Melhor Envio provides a sandbox at sandbox.melhorenvio.com.br. Set MELHOR_ENVIO_SANDBOX=true to use it.

Get your credentials

1. Go to Melhor Envio
2. Create an account
3. Navigate to API settings and generate a token
4. Set the MELHOR_ENVIO_TOKEN environment variable

Environment Variables

Variable	Required	Description
MELHOR_ENVIO_TOKEN	Yes	Bearer token from Melhor Envio
MELHOR_ENVIO_SANDBOX	No	Set to "true" for sandbox mode

Roadmap

v0.2 (planned)

• create_store — Create a store in Melhor Envio
• update_store — Update store details
• get_receipt — Get shipping receipt/label
• list_companies — List available shipping companies
• get_invoice — Get invoice for a shipment

v0.3 (planned)

• batch_shipments — Create multiple shipments in a single request
• detailed_reports — Generate detailed shipping reports
• webhook_management — Register, list, and delete webhooks

Want to contribute? Open a PR or request a tool.

Links

• Melhor Envio Website
• Melhor Envio API Documentation
• MCP Dev LATAM
• Landing Page

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT