feat(superfrete): add MCP server with 11 tools (carries over #3)

README.md

@@ -5,7 +5,7 @@
     <em>Brazil 🇧🇷 · Mexico 🇲🇽 · Argentina 🇦🇷 · Colombia 🇨🇴 · Chile 🇨🇱 · Peru 🇵🇪 · plus 4 agentic payment protocols.</em>
   </p>
   <p align="center">
-    109 MCP servers · 2,289 tools · 6 countries · MIT License
+    110 MCP servers · 2,300 tools · 6 countries · MIT License
   </p>
   <p align="center">
     <a href="https://codespar.dev/servers">Catalog</a> ·
@@ -16,8 +16,8 @@
   </p>
   <p align="center">
     <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
-    <img src="https://img.shields.io/badge/servers-109-green" alt="109 servers">
-    <img src="https://img.shields.io/badge/tools-2,289-orange" alt="2289 tools">
+    <img src="https://img.shields.io/badge/servers-110-green" alt="110 servers">
+    <img src="https://img.shields.io/badge/tools-2,300-orange" alt="2300 tools">
     <img src="https://img.shields.io/badge/countries-6-blue" alt="6 countries">
     <img src="https://img.shields.io/badge/MCP-compatible-purple" alt="MCP compatible">
   </p>
@@ -279,7 +279,7 @@ Browse the full catalog at [codespar.dev/servers](https://codespar.dev/servers).
 | **[Take Blip](packages/communication/take-blip)** | 18 | `@codespar/mcp-take-blip` | API Key |
 | **[Zenvia](packages/communication/zenvia)** | 18 | `@codespar/mcp-zenvia` | API Key |
 
-### 📦 E-commerce / Logistics (6 servers)
+### 📦 E-commerce / Logistics (7 servers)
 
 | Server | Tools | npm | Auth |
 |---|---|---|---|
@@ -289,6 +289,7 @@ Browse the full catalog at [codespar.dev/servers](https://codespar.dev/servers).
 | **[Shopee](packages/ecommerce/shopee)** <sub>alpha</sub> | 22 | `@codespar/mcp-shopee` | API Key |
 | **[Correios](packages/ecommerce/correios)** <sub>alpha</sub> | 21 | `@codespar/mcp-correios` | API Key |
 | **[Melhor Envio](packages/ecommerce/melhor-envio)** | 18 | `@codespar/mcp-melhor-envio` | API Key |
+| **[SuperFrete](packages/ecommerce/superfrete)** | 11 | `@codespar/mcp-superfrete` | API Key |
 
 ### 📊 ERP / Accounting (5 servers)
 

packages/ecommerce/superfrete/README.md

@@ -0,0 +1,122 @@
+# @codespar/mcp-superfrete
+
+> MCP server for **SuperFrete** — Brazilian shipping platform with discounted rates across multiple carriers
+
+[![npm](https://img.shields.io/npm/v/@codespar/mcp-superfrete)](https://www.npmjs.com/package/@codespar/mcp-superfrete)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+## Quick Start
+
+### Claude Desktop
+
+Add to `~/.config/claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "superfrete": {
+      "command": "npx",
+      "args": ["-y", "@codespar/mcp-superfrete"],
+      "env": {
+        "SUPERFRETE_TOKEN": "your-token",
+        "SUPERFRETE_SANDBOX": "true"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add superfrete -- npx @codespar/mcp-superfrete
+```
+
+### Cursor / VS Code
+
+Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "superfrete": {
+      "command": "npx",
+      "args": ["-y", "@codespar/mcp-superfrete"],
+      "env": {
+        "SUPERFRETE_TOKEN": "your-token",
+        "SUPERFRETE_SANDBOX": "true"
+      }
+    }
+  }
+}
+```
+
+## Tools (11)
+
+| Tool | Description |
+|------|-------------|
+| `calculate_freight` | Calculate shipping rates across carriers (PAC, SEDEX, JadLog, Loggi, Mini Envios) |
+| `create_freight` | Create a freight/label order |
+| `get_freight` | Get freight order details, status, and tracking |
+| `checkout_freight` | Purchase freight orders and generate labels |
+| `cancel_freight` | Cancel a freight order |
+| `get_user_info` | Get user info, balance, and shipment limits |
+| `get_user_addresses` | List saved addresses |
+| `get_services` | Get available services with restrictions and limits |
+| `list_webhooks` | List configured webhooks |
+| `create_webhook` | Create a webhook for order event notifications |
+| `delete_webhook` | Delete a webhook |
+
+## Authentication
+
+SuperFrete uses a Bearer token (API key) for authentication.
+
+## Sandbox / Testing
+
+SuperFrete provides a sandbox environment. Set `SUPERFRETE_SANDBOX=true` to use it.
+
+### Get your credentials
+
+1. Go to [SuperFrete](https://superfrete.com) and create an account
+2. Navigate to [Integrations](https://web.superfrete.com/#/integrations/select-integration-platform)
+3. Click **"Desenvolvedores"** → **"Integrar"** to generate your API token
+4. Set the `SUPERFRETE_TOKEN` environment variable
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `SUPERFRETE_TOKEN` | Yes | API Bearer token from SuperFrete |
+| `SUPERFRETE_SANDBOX` | No | Set to `"true"` for sandbox mode |
+
+## Available Services
+
+| ID | Service | Carrier |
+|----|---------|---------|
+| 1 | PAC | Correios |
+| 2 | SEDEX | Correios |
+| 3 | .Package | JadLog |
+| 17 | Mini Envios | Correios |
+| 31 | Loggi | Loggi |
+
+## Typical Workflow
+
+1. **Calculate rates** with `calculate_freight` — get prices and delivery times for all carriers
+2. **Create order** with `create_freight` — select a service and provide addresses
+3. **Checkout** with `checkout_freight` — pay for the order and generate the label
+4. **Track** with `get_freight` — monitor status and get the label print URL
+
+## Links
+
+- [SuperFrete Website](https://superfrete.com)
+- [SuperFrete API Documentation](https://docs.superfrete.com)
+- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)
+- [Catalog](https://codespar.dev/servers)
+
+## Enterprise
+
+Need governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.
+
+## License
+
+MIT

packages/ecommerce/superfrete/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@codespar/mcp-superfrete",
+  "version": "0.1.0",
+  "description": "MCP server for SuperFrete shipping API - freight calculation, label creation, tracking, and account management for Brazilian logistics",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "mcp-superfrete": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "superfrete",
+    "shipping",
+    "freight",
+    "logistics",
+    "brazil",
+    "e-commerce"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.8.0"
+  },
+  "mcpName": "io.github.codespar/mcp-superfrete"
+}

packages/ecommerce/superfrete/server.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.codespar/mcp-superfrete",
+  "description": "MCP server for SuperFrete — Brazilian shipping platform with discounted rates across PAC, SEDEX, JadLog, Loggi, and Mini Envios",
+  "repository": {
+    "url": "https://github.com/codespar/mcp-dev-latam",
+    "source": "github",
+    "subfolder": "packages/ecommerce/superfrete"
+  },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@codespar/mcp-superfrete",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "SUPERFRETE_TOKEN",
+          "description": "SuperFrete API Bearer token from https://web.superfrete.com/#/integrations",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": true
+        },
+        {
+          "name": "SUPERFRETE_SANDBOX",
+          "description": "Set to 'true' to use the sandbox API (https://sandbox.superfrete.com/). Defaults to production.",
+          "isRequired": false,
+          "format": "string",
+          "isSecret": false
+        }
+      ]
+    }
+  ],
+  "provider": {
+    "homepage": "https://superfrete.com",
+    "logoUrl": "https://logo.clearbit.com/superfrete.com",
+    "logoFallback": "https://www.google.com/s2/favicons?domain=superfrete.com&sz=128",
+    "docsUrl": "https://superfrete.com/desenvolvedores",
+    "sandbox": {
+      "available": true
+    }
+  }
+}