---
title: "BSC Designer integration for LuumenAI"
url: "https://www.luumen.ai/integrations/bsc-designer/"
entity: SoftwareIntegration
category: "Databases & data platforms"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# BSC Designer integration for LuumenAI

Read scorecards and KPI history, then post indicator values as approved steps

## What LuumenAI can do with BSC Designer

LuumenAI connects to BSC Designer with an API token and exposes 10 tools (7 read-only · 2 write · 1 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 10 tools (7 read-only · 2 write · 1 destructive)
- Plan: available on all plans
- Category: Databases & data platforms

## About BSC Designer with LuumenAI

Connect BSC Designer and your scorecards become something you can ask questions about from the terminal. List documents, pull an indicator's value against its baseline and target, group history by month or quarter, and pull the Excel report. When a number needs updating, Luumen shows the change first and posts it after you approve. Authentication uses an API key.

## Example tools

Read-only (7 in total):

- `BSC_DESIGNER_DOWNLOAD_EXCEL_REPORT` — Generate and download a scorecard's Excel report, optionally evaluated at a specified date.
- `BSC_DESIGNER_GET_DOCUMENT` — Get metadata and sharing settings for one scorecard document by numeric ID or alias.
- `BSC_DESIGNER_GET_GROUPED_INDICATOR_VALUES` — Get one indicator's values grouped by day, week, month, quarter, half-year, or year over an explicit date range.
- `BSC_DESIGNER_GET_INDICATOR_VALUE` — Get one indicator's value, baseline, target, minimum, and maximum for the requested as-of date under its update-interval and value-inheritance settings, including each metric's effective date.
- `BSC_DESIGNER_GET_SCORECARD_ITEM` — Get detailed metadata for one scorecard item, such as an indicator, goal, or initiative, using its exact item identifier.
- `BSC_DESIGNER_LIST_DOCUMENTS` — List scorecard documents owned by or shared with the connected user, returning IDs and aliases for subsequent scorecard operations.
- `BSC_DESIGNER_LIST_SCORECARD_ITEMS` — List the goals, perspectives, indicators, initiatives, risks, rationales, and expected outcomes in a scorecard, with optional local filtering for value-bearing indicators.

Write and destructive (3 in total, approval required by default):

- `BSC_DESIGNER_BALANCE_SCORECARD_WEIGHTS` — Recalculate and persist balanced indicator weights across a scorecard, returning every changed old and new weight.
- `BSC_DESIGNER_SET_INDICATOR_VALUES` — Set one or more indicators' value, baseline, target, minimum, or maximum in one batch request.
- `BSC_DESIGNER_UPDATE_INDICATOR` — Update an indicator's name, description, or leading/lagging business type without changing its measured values.

## Frequently asked questions

### How does LuumenAI connect to BSC Designer?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in BSC Designer on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 1 action classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to BSC Designer — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/bsc-designer/