Skill de Claude para calcular peajes: cómo montarla sobre la API
Respuesta directa: una skill de Claude es una carpeta con instrucciones (y opcionalmente scripts) que enseña a Claude a hacer una tarea concreta con herramientas que ya tenga disponibles. Para calcular peajes, la skill no añade conexión de red por sí misma: necesita un canal real hacia la API —el servidor MCP documentado por Cargoffer o una llamada HTTP desde un entorno con red—. La skill escribe el conocimiento (qué endpoint, qué clase de vehículo, cómo interpretar el desglose); MCP o la ejecución de scripts aportan la llamada.
Cuándo usar skill, cuándo MCP
- Si usas Claude con herramientas de red (Claude Code en local, o Claude con el servidor MCP de peajes configurado): la skill es suficiente como capa de conocimiento y flujo de trabajo.
- Si solo tienes Claude chat sin herramientas: una skill no podrá consultar la API; usa la integración MCP en Claude Desktop (guía) o el patrón de GPT/app con function calling.
Estructura de ejemplo de la skill
skills/tolls-calculator/
├── SKILL.md
└── scripts/
└── calculate_tolls.sh # curl al endpoint con la API key desde variables de entorno
SKILL.md (esqueleto):
---
name: tolls-calculator
description: Calcula el coste de peaje de una ruta usando la API de Tolls Calculator.
---
# Calcular peajes
1. Pide o recupera del contexto: origen, destino (o polilínea), clase de vehículo y método de pago.
2. Si no hay polilínea, usa el endpoint de costes con waypoints: POST https://api.cargoffer.com/costs/calculate.
3. Si hay polilínea: ejecuta scripts/calculate_tolls.sh, que llama a
POST https://back.transcend.cargoffer.com/api/v1/tolls/calculate
con Authorization: Bearer $CARGOFFER_API_KEY.
4. Presenta el desglose por tramos y la fecha de consulta.
5. Nunca presentes un importe sin la respuesta de la llamada: las tarifas cambian.
El script es un curl con el payload JSON; la API key se lee del entorno y no se escribe en la skill.
Flujo recomendado para un equipo
- Configura primero el transporte: MCP (
npx -y @cargoffer/mcp-server-transcend@latest) en Claude Desktop o Claude Code. - Añade la skill encima para fijar el procedimiento: cómo preguntar datos del vehículo, cómo reportar el desglose, cómo marcar resultados como estimación.
- Guarda la API key solo en variables de entorno locales.
Esto replicará el patrón que ya documentamos para editores: integración en Cursor usa el mismo servidor MCP.
Aviso: esta skill es un patrón de integración que construyes tú. No afirmamos que exista una skill oficial publicada; lo verificado es el endpoint y el servidor MCP documentados.