@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