StackSpend MCP

npx add-mcp 'https://api.stackspend.app/api/v1/mcp'

Qué hace

El servidor MCP de StackSpend implementa el Protocolo de Contexto de Modelo para que Claude Code pueda leer tus datos de StackSpend como contexto. Una vez configurado, puedes preguntar sobre tus costos de nube e IA — por proveedor, servicio, modelo, proyecto, usuario, rango de fechas o anomalía — y obtener respuestas basadas en tu gasto real.

Las herramientas de lectura cubren resúmenes de gasto, pronósticos contra presupuesto, salud de proveedores, resúmenes consolidados, partidas individuales, anomalías y tareas. Las herramientas de escritura permiten que Claude clasifique una anomalía o abra una tarea para el equipo — solo cuando lo pidas explícitamente.

Se requiere plan Business. El servidor MCP utiliza la API pública de StackSpend, que requiere una suscripción al plan Business.

Configuración

1

Crea una clave de API

Ve a Configuración → API y haz clic en Crear clave de API. Ponle un nombre como "Claude Code MCP". Las claves nuevas incluyen los alcances que el servidor MCP necesita:

• spend:read, providers:read, rollups:read, line_items:read, anomalies:read, tasks:read
• anomalies:write y tasks:write para las acciones de clasificación

Copia la clave — solo se muestra una vez. Guárdala en un lugar seguro.

Añade el servidor a Claude Code

La forma más rápida es mediante la CLI de Claude Code:

claude mcp add stackspend --env STACKSPEND_API_KEY=your_api_key_here -- npx -y @stackspend/mcp-server

O añádelo manualmente a ~/.claude.json (todos los proyectos) o .mcp.json en la raíz de tu proyecto (compartido con tu equipo):

{
  "mcpServers": {
    "stackspend": {
      "command": "npx",
      "args": ["-y", "@stackspend/mcp-server"],
      "env": {
        "STACKSPEND_API_KEY": "your_api_key_here"
      }
    }
  }
}

Consejo. El mismo bloque mcpServers funciona en Claude Desktop, en su propio archivo de configuración.

3

Reinicia Claude Code

Vuelve a abrir Claude Code y ejecuta /mcp. Deberías ver stackspend listado como conectado.

Qué puedes preguntar

• "¿Vamos bien encaminados contra el presupuesto este mes?"
• "¿Cuál es mi gasto en AWS este mes y la conexión está saludable?"
• "¿Qué modelos de OpenAI son los más caros?"
• "¿Hay anomalías abiertas? ¿Qué causó la más grande?"
• "¿Qué servicio tuvo el mayor aumento de costos la semana pasada?"
• "Abre una tarea para redimensionar esa instancia y asígnala a mí."

Herramientas

Gasto y pronóstico

Herramienta	Alcance	Qué devuelve
get_spend_summary	spend:read	Ayer, últimos 7 días, últimos 30 días y mes hasta la fecha, cada uno con tendencia y estado, para el portafolio y por proveedor. Incluye la fecha de datos más reciente para que puedas distinguir conexiones obsoletas de gasto realmente bajo.
get_forecast	spend:read	Proyección de fin de mes contra presupuesto, días hasta superar el presupuesto, y ritmo y momento por proveedor.
get_savings	spend:read	Sobre-gasto evitado al resolver anomalías, este mes y de por vida.
get_providers	providers:read	Salud de la conexión: última sincronización, último error, si un proveedor necesita reconexión.

Datos de costos

Herramienta	Alcance	Qué devuelve
get_daily_rollups	rollups:read	Totales diarios agrupados por proveedor, servicio, categoría, proyecto, usuario, cuenta o modelo.
get_line_items	line_items:read	Partidas individuales sin procesar, paginadas con cursor, filtrables por cualquier dimensión incluido el modelo.

Anomalías

Herramienta	Alcance	Qué devuelve
get_anomalies	anomalies:read	Picos de gasto detectados con exceso, estado y — con control de fuentes conectado — la PR probablemente contribuyente.
get_anomaly_detail	anomalies:read	El registro de cambios clasificado para una anomalía: PRs y despliegues con confianza, evidencia y archivos modificados.
update_anomaly_status	anomalies:write	Reconocer, resolver, descartar o marcar como falso positivo. Resolver o descartar requiere una nota.
set_anomaly_severity	anomalies:write	Re-priorizar una anomalía.
add_anomaly_comment	anomalies:write	Comentar en un hilo de anomalía.

Tareas

Herramienta	Alcance	Qué devuelve
list_tasks	tasks:read	Tareas de FinOps: revisiones de presupuesto, oportunidades de optimización, seguimientos de ahorro y recomendaciones de modelos.
create_task	tasks:write	Crear una tarea de optimización, sincronizada con un proyecto Jira o Linear conectado.
update_task	tasks:write	Transicionar una tarea hasta cerrada.

Las herramientas de escritura necesitan una instrucción explícita. Claude no cerrará una anomalía ni abrirá una tarea por su cuenta. Resolver o descartar una anomalía requiere una nota, y cada escritura se atribuye al propietario de la clave de API.

MCP alojado (OAuth)

Para clientes que necesitan una URL MCP remota en lugar de un comando local — conectores personalizados de Claude, por ejemplo — StackSpend puede exponer las mismas herramientas a través de OAuth. Crea un cliente OAuth en Configuración → API y luego apunta tu cliente a:

https://api.stackspend.app/api/v1/mcp

Los metadatos de descubrimiento se sirven desde /.well-known/oauth-authorization-server y /.well-known/oauth-protected-resource en el mismo host. El flujo es código de autorización con PKCE.

Habilitado por defecto. El MCP alojado está activo a menos que tu implementación lo haya desactivado. Si el descubrimiento devuelve HOSTED_MCP_DISABLED, usa la configuración local anterior o contacta con soporte.

Prompts

Los clientes que admiten prompts MCP obtienen cuatro flujos de trabajo guiados. Cada uno secuencia las herramientas adecuadas y le indica al modelo que verifique la frescura de los datos antes de confiar en un número.

Prompt	Qué hace
cost_review	Dónde está el gasto, qué cambió y qué hacer — opcionalmente para un período nombrado
explain_anomaly	Diagnosticar un pico desde su registro de cambios, o tomar el más grande abierto
find_savings	Gasto reducible y oportunidades ya registradas, clasificadas por ahorro anualizado
check_connections	Verificar que los datos fluyen antes de confiar en cualquier número

Moneda

Los montos se devuelven en la moneda de visualización de tu organización, indicada en la respuesta. cost y net_amount se convierten; cost_usd y net_amount_usd permanecen en USD, por lo que un script que ya lee los campos USD sigue funcionando.

Solución de problemas

• Servidor no listado en /mcp — verifica que el archivo de configuración que editaste sea ~/.claude.json o .mcp.json, y que el bloque se llame mcpServers.
• Conexión rechazada o tiempo de espera agotado — establece STACKSPEND_API_BASE_URL si tu API no está en https://api.stackspend.app.
• 401 No autorizado — la clave no es válida o fue revocada. Crea una nueva.
• Falta alcance requerido — la clave es anterior a una herramienta. Crea una clave nueva para obtener los alcances actuales.
• Se requiere plan Business — el acceso a la API es parte del plan Business.

Acceso directo a la API. El servidor MCP llama a los mismos endpoints de API pública disponibles para todos los suscriptores del plan Business. Puedes llamarlos directamente para integraciones personalizadas, scripts o paneles de control.