Sisense MCP Server

A Model Context Protocol (MCP) server that provides integration with Sisense analytics platform. This server enables LLMs to interact with Sisense data models and create charts programmatically.

Features

• Transport: Streamable HTTP (streamable-http) for HTTP-based MCP clients (for example Claude Desktop, Cursor)
• MCP tools (three by default; optional fourth when enabled):
  • getDataSources: Retrieve Sisense data sources (or data models)
  • getDataSourceFields: List all available fields for a specific data source
  • buildChart: Build charts from natural language prompts
  • buildQuery (optional): Run analytics queries when TOOL_BUILD_QUERY_ENABLED / toolBuildQueryEnabled is enabled
• MCP Apps: When used in MCP Apps–capable clients (for example Claude), buildChart exposes an interactive View that renders the chart in an iframe within the app.
• Per-session authentication: Sisense credentials via URL parameters and/or server environment variables
• TypeScript: Full type safety and modern ESM support
• Lightweight: Pure Node.js HTTP server, no heavy frameworks
• Fast: Optimized for Bun runtime, also runs on Node.js

Documentation

• Quick start — clone, .env, run, MCP client setup
• Configuration — credentials, tunneling, feature flags, URL examples
• FAQ — common questions and troubleshooting
• Usage examples — prompts and workflows

Prerequisites

• Node.js >= 18.0.0 (required for local development and npm)
• Bun for running project scripts (dev, build, start, tests): the bun package is a devDependency, so after npm install or bun install the Bun binary is available under node_modules/.bin—a global Bun install is not required. A global Bun install is optional.
• Sisense instance with API access
• Sisense API token
• Playwright Chromium (installed automatically by bun install / npm install via postinstall)

Installation

bun install
# or
npm install

Usage

Start the server:

# Development mode (hot reload)
bun run dev
# or
npm run dev

# Production mode
bun run build && bun run start
# or
npm run build && npm run start

Sessions are in-memory — chart state is lost if the server restarts.

The server prints something like the following (port defaults to 3001, or PORT if set):

Sisense MCP Server running on http://localhost:3001

Connect with:
  http://localhost:3001/mcp?sisenseUrl=<SISENSE_URL>&sisenseToken=<SISENSE_TOKEN>
  Or set SISENSE_URL and SISENSE_TOKEN in the environment and use http://localhost:3001/mcp

Optional feature-flag query params (override env vars per connection):
  mcpAppEnabled=true|false, toolBuildQueryEnabled=true|false, toolBuildChartNarrativeEnabled=true|false

Endpoints:
  Health: http://localhost:3001/health
  Screenshots: http://localhost:3001/screenshots/

Connecting your MCP client

Use an MCP streamable HTTP URL. For Cursor, Claude Desktop, and similar clients, add a server entry with the MCP path (not a shell command such as bun run dev or npm run dev).

If SISENSE_URL and SISENSE_TOKEN are set in the server environment (for example in .env loaded by the process that runs bun run dev or npm run dev), the client URL does not need to include credentials:

{
  "mcpServers": {
    "sisense-analytics": {
      "url": "http://localhost:3001/mcp"
    }
  }
}

Note: Depending on your network or client environment, the localhost HTTP setup may not connect. In those cases, you will need to expose your local server publicly via HTTPS using a proxy service such as ngrok. Point the client at your HTTPS tunnel URL with the same /mcp path (and query parameters if you are not using server env credentials).

Credentials: If you do not use server env v

... View full README on GitHub