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 de agente y plugin

El 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 un prompt con líneas de facturación sin procesar de AWS o GCP 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 único esquema, asigna el coste compartido y sin etiquetar a partir de métricas de uso reales, y correlaciona el gasto con eventos de despliegue e incidentes. El asistente llama entonces a herramientas estructuradas sobre datos que ya están asignados y explicados.

Este repositorio contiene las habilidades de agente que se sitúan sobre esas herramientas: los flujos de trabajo que convierten «¿por qué se disparó el coste 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 gratuita de 15 días disponible.

Claude Desktop / Claude Code / Cursor / VS Code: añade un conector personalizado que apunte a https://app-api.costory.io/mcp y 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 de 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 las cargas útiles están versionados; la referencia de la API es la fuente de verdad.

Grupo	Herramientas	Qué hacen
Orientación	`get_context`, `search`, `get`, `suggest_groupby`, `suggest_usage_metrics`, `suggest_actions`	Descubre dimensiones, paneles, métricas y la forma correcta de segmentar una pregunta
Consulta	`query`, `list_metrics`, `list_virtual_dimensions`	Consultas de coste, uso, métricas, fórmulas y presupuestos con comparación entre periodos
Asignación	`create_virtual_dimension_draft`, `update_virtual_dimension_draft`, `preview_virtual_dimension_draft`, `publish_virtual_dimension`, `virtual_dimension_overlap_matrix`	Define ejes de coste personalizados con reglas CEL ordenadas, previsualiza y publica
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 coste 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, de modo que el asistente no tenga que redescubrirlo.

MCP `skillId`	Úsalo cuando
`query`	Investigación de coste, uso, métricas, fórmulas y presupuestos. Explora solo entre periodos; pasa «qué cambió» a `reports` Explain
`virtual-dimensions`	Crea, edita, previsualiza y publica ejes de coste personalizados con reglas CEL ordenadas
`dashboards`	Crea o amplía paneles con herencia de widgets centrada en el contexto y generación de resúmenes
`reports`	Informes programados por Slack, Teams y correo electrónico, y DIGEST con vista previa para explicar el coste del último mes
`recipes`	Diseños de seguimiento listos para usar, adaptados a un resultado y luego entregados a las habilidades anteriores para su construcción

Las recetas cubren actualmente paneles de presupuesto frente a real, alertas de picos de EC2, divisiones producción frente a I+D, cobertura sin etiquetar, gasto en marketplace, créditos de proveedor, coste por namespace, desgloses de cómputo y explicación de cambios entre periodos. 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/
    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 asigna cada MCP skillId a una ruta SKILL.md. Al conectar costory-app, carga el archivo de este repositorio (o de una versión fijada), elimina el frontmatter YAML opcional y devuelve el cuerpo de markdown.

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

Creación

Consulta AGENTS.md para conocer las reglas de estructura, los incrementos de versión y la validación. Usa SKILL_TEMPLATE.md al añadir una habilidad.

Licencia

Apache-2.0, consulta LICENSE.