Table Charts

# @tablecharts/mcp-server

Servidor MCP para TableCharts: convierte tablas (CSV, JSON, Notion, Google Sheets, Salesforce) en paneles interactivos compartibles, directamente desde Claude, Cursor, VS Code o cualquier otro cliente MCP.

Por qué

Los LLM son excelentes generando datos estructurados, pero pésimos creando gráficos reales. Este servidor le brinda a cualquier asistente compatible con MCP una herramienta de un solo paso para convertir datos tabulares en un panel alojado e incrustable con una URL pública.

Instalación

npm i -g @tablecharts/mcp-server

O ejecútalo bajo demanda con npx -y @tablecharts/mcp-server: no requiere instalación.

Obtén una clave de API

1. Regístrate en https://tablecharts.co
2. Abre https://tablecharts.co/api-keys
3. Crea una clave que comience con tc_live_…

Configura tu cliente MCP

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "tablecharts": {
      "command": "npx",
      "args": ["-y", "@tablecharts/mcp-server"],
      "env": {
        "TABLECHARTS_API_KEY": "tc_live_..."
      }
    }
  }
}

Reinicia Claude Desktop. La herramienta generate_dashboard aparecerá en el menú de herramientas.

Cursor

Agrega a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "tablecharts": {
      "command": "npx",
      "args": ["-y", "@tablecharts/mcp-server"],
      "env": { "TABLECHARTS_API_KEY": "tc_live_..." }
    }
  }
}

VS Code (con la extensión MCP)

{
  "mcp.servers": {
    "tablecharts": {
      "command": "npx",
      "args": ["-y", "@tablecharts/mcp-server"],
      "env": { "TABLECHARTS_API_KEY": "tc_live_..." }
    }
  }
}

Herramientas

Herramienta	Descripción
generate_dashboard	Crea un panel a partir de data (filas JSON), csv (cadena) o source_url (Notion / Google Sheets / Salesforce). Devuelve dashboard_url, embed_url, iframe_code.
list_chart_types	Devuelve los 6 tipos de gráficos compatibles: bar, line, area, pie, scatter, radar.

Ejemplos de indicaciones

• "Grafica mis ingresos mensuales: Ene 12k, Feb 15k, Mar 18k, Abr 22k. Usa TableCharts."
• "Extrae esta base de datos de Notion y crea un panel: https://notion.so/…"
• "Toma este CSV y elige automáticamente el mejor tipo de gráfico."

Variables de entorno

Variable	Obligatoria	Descripción
TABLECHARTS_API_KEY	sí	Tu clave de tc_live_… desde https://tablecharts.co/api-keys
TABLECHARTS_API_BASE	no	Sobrescribe la base de la API (por defecto https://tablecharts.co)

Límites

• Plan gratuito: 3 gráficos guardados, 30 solicitudes/minuto.
• Plan Pro: gráficos ilimitados, limpieza con IA, recomendación de gráficos con IA, colores personalizados, sin marca de agua.

Licencia

MIT