Costory

Haz a tu asistente de IA una pregunta sobre costos. Obtén asignación, correlación y explicación en una sola respuesta. Costory conecta Claude, Codex o Cursor con datos de costos normalizados en AWS, GCP, Azure, Datadog, OpenAI y Anthropic.

GitHub

Prueba este MCPPatrocinado

Documentación

Costory FinOps MCP: habilidades del agente y plugin

El servidor Costory FinOps MCP es un servidor alojado de Model Context Protocol que permite a Claude, Cursor, VS Code, Codex o Dust responder preguntas sobre tu gasto en la nube y en IA.

Alimentar líneas de facturación sin procesar de AWS o GCP en un prompt no funciona. Costory actúa como una capa de contexto: normaliza la facturación de AWS, GCP, Azure, Snowflake, Datadog, OpenAI y Anthropic en un solo esquema, asigna costos compartidos y sin etiquetar a partir de métricas de uso reales, y correlaciona el gasto con eventos de despliegue e incidentes. El asistente luego llama a herramientas estructuradas sobre datos que ya están asignados y explicados.

Este repositorio contiene las habilidades del agente que se sitúan sobre esas herramientas: los flujos de trabajo que convierten "¿por qué saltó el costo de producción la semana pasada?" en la secuencia correcta de llamadas a herramientas.

Documentación completa de MCP: docs.costory.io/features/mcp
Endpoint: https://app-api.costory.io/mcp
Autenticación: OAuth, sin credenciales IAM, sin Docker, sin servidor local

Conectar el MCP

Necesitas un espacio de trabajo de Costory con datos de facturación conectados. Hay una prueba de 15 días disponible.

Claude Desktop / Claude Code / Cursor / VS Code: agrega un conector personalizado apuntando a https://app-api.costory.io/mcp, luego completa el inicio de sesión OAuth en la ventana del navegador que se abre. Las guías paso a paso por cliente con capturas de pantalla están en la documentación de MCP.

Este repositorio incluye un .mcp.json que puedes copiar:

{
  "mcpServers": {
    "costory": {
      "type": "http",
      "url": "https://app-api.costory.io/mcp",
      "oauth": { "callbackPort": 8080 }
    }
  }
}

Para clientes sin soporte nativo de MCP remoto, haz un proxy con mcp-remote:

{
  "mcpServers": {
    "costory": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app-api.costory.io/mcp"]
    }
  }
}

Referencia de herramientas MCP

El servidor expone herramientas en cinco grupos. Los nombres y cargas útiles están versionados; la referencia de API es la fuente de verdad.

Grupo	Herramientas	Qué hacen
Orientación	`get_context`, `search`, `get`, `suggest_groupby`, `suggest_usage_metrics`, `suggest_actions`	Descubrir dimensiones, paneles, métricas y la forma correcta de segmentar una pregunta
Consulta	`query`, `list_metrics`, `list_virtual_dimensions`	Consultas de costo, uso, métrica, fórmula y presupuesto con comparación entre períodos
Asignación	`create_virtual_dimension_draft`, `update_virtual_dimension_draft`, `preview_virtual_dimension_draft`, `publish_virtual_dimension`, `virtual_dimension_overlap_matrix`	Definir ejes de costo personalizados con reglas CEL ordenadas, previsualizar y luego publicar
Informes	`create_report`, `update_report`, `preview_report_widget`, `run_report_now`, `create_dashboard`, `update_dashboard`	Informes programados por Slack, Teams y correo electrónico, además de paneles creados desde el chat
Alertas y eventos	`create_alert`, `preview_alert`, `list_alerts`, `create_event`, `update_event`	Alertas de costo y presupuesto, y anotaciones de eventos para correlación

Las herramientas de escritura actúan solo dentro de tu espacio de trabajo de Costory. El alcance de las consultas sigue el rol del usuario que llama en el espacio de trabajo.

Habilidades FinOps

Las habilidades son la capa de flujo de trabajo: cada una codifica cómo secuenciar las herramientas anteriores para una clase de pregunta, para que el asistente no tenga que redescubrirlo.

MCP `skillId`	Úsalo cuando
`bigquery`	Advertencias del almacén de BigQuery (bajo demanda vs slots, físico vs lógico, etiquetas) más la plantilla de panel [BigQuery]
`cost-change-investigation`	Explicar un cambio de costo con evidencia de contribución, tiempo, uso, métrica, evento, alerta y terminología
`query`	Investigación de costo, uso, métrica, fórmula y presupuesto. Explorador solo entre períodos; entrega "qué cambió" a `reports` Explicar
`virtual-dimensions`	Crear, editar, previsualizar y publicar ejes de costo personalizados con reglas CEL ordenadas
`dashboards`	Crear o ampliar paneles con herencia de widgets priorizando el contexto y generación de resumen
`reports`	Informes programados por Slack, Teams y correo electrónico, y DIGEST con vista previa para explicar el costo del último mes
`recipes`	Diseños de seguimiento listos para usar alineados con un resultado, luego entregados a las habilidades anteriores para construir

Las recetas actualmente cubren enrutamiento de almacenes de BigQuery, CUDs basados en gasto de GCP, paneles de presupuesto vs real, alertas de picos de EC2, divisiones prod vs I+D, cobertura sin etiquetar, gasto de marketplace, créditos de proveedor, costo por namespace, desgloses de cómputo y explicación de cambios entre períodos. Consulta plugins/costory/skills/recipes/.

Instalar como plugin

# Claude Code
claude plugin marketplace add costory-io/costory-finops-mcp-skills
claude plugin install costory@costory

# Codex
codex plugin marketplace add costory-io/costory-finops-mcp-skills
codex plugin add costory@costory

Estructura

.mcp.json                              ← ready-to-copy MCP client config
skills.json                            ← MCP skillId -> SKILL.md path
.claude-plugin/marketplace.json
plugins/costory/
  .claude-plugin/plugin.json
  skills/
    bigquery/SKILL.md
    cost-change-investigation/SKILL.md
    query/SKILL.md
    virtual-dimensions/SKILL.md
    dashboards/SKILL.md
    reports/SKILL.md
    recipes/SKILL.md  + recipe library

Servir habilidades a través de MCP (`get_skill`)

skills.json mapea cada MCP skillId a una ruta de SKILL.md. Al conectar costory-app, carga el archivo desde este repositorio (o una versión fija), elimina el frontmatter YAML opcional y devuelve el cuerpo de markdown.

{
  "skillId": "dashboards",
  "path": "plugins/costory/skills/dashboards/SKILL.md"
}

Autoría

Consulta AGENTS.md para reglas de estructura, incrementos de versión y validación. Usa SKILL_TEMPLATE.md al agregar una habilidad.

Licencia

Apache-2.0, consulta LICENSE.