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

# Simplekpi integration for LuumenAI

Read KPI data and scorecards, then add or change KPIs as approved steps

## What LuumenAI can do with Simplekpi

LuumenAI connects to Simplekpi with Basic auth and exposes 51 tools (24 read-only · 17 write · 10 destructive). For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

## Key facts

- Authentication: Basic auth
- Tools available: 51 tools (24 read-only · 17 write · 10 destructive)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Databases & data platforms

## About Simplekpi with LuumenAI

Connect SimpleKPI and your agent can read the whole scorecard: KPI definitions, categories, frequencies, units, entries, and the processed data behind reports. Ask what a metric currently shows or how a category is structured and you get an answer right away. Changes, like creating a KPI or assigning one to a user, are previewed and sent for approval first.

## Example tools

Read-only (24 in total):

- `SIMPLEKPI_GET_ALL_DATA_ENTRIES` — Retrieve processed KPI data entries for reports including calculated KPIs.
- `SIMPLEKPI_GET_CATEGORY_KPI` — Retrieve a specific KPI within a category.
- `SIMPLEKPI_GET_GROUP` — Get a specific group by ID from SimplekPI.
- `SIMPLEKPI_GET_GROUP_ITEM` — Retrieve a specific group item by ID.
- `SIMPLEKPI_GET_KPI` — Retrieve a specific KPI by ID from SimpleKPI.
- `SIMPLEKPI_GET_KPI_CATEGORY` — Get a specific KPI category by ID from SimpleKPI.
- `SIMPLEKPI_GET_KPI_ENTRY` — Retrieve a specific KPI entry by ID.
- `SIMPLEKPI_GET_KPI_FREQUENCY` — Get a specific KPI frequency by ID from SimplekPI.

Write and destructive (27 in total, subject to configured approval policy):

- `SIMPLEKPI_ADD_USER_GROUP_ITEM` — Assign a group item to a user in SimpleKPI.
- `SIMPLEKPI_ADD_USER_KPI` — Assign a KPI to a user in SimpleKPI.
- `SIMPLEKPI_CREATE_CATEGORY_KPI` — Create a new KPI within a category in SimpleKPI.
- `SIMPLEKPI_CREATE_GROUP` — Create a new group in SimpleKPI.
- `SIMPLEKPI_CREATE_GROUP_ITEM` — Create a new item within a group in SimpleKPI.
- `SIMPLEKPI_CREATE_KPI` — Create a new KPI with specified configuration.
- `SIMPLEKPI_CREATE_KPI_CATEGORY` — Create a new KPI category in SimpleKPI.
- `SIMPLEKPI_CREATE_KPI_UNIT` — Create a new KPI unit in SimpleKPI.

## Frequently asked questions

### How does LuumenAI connect to Simplekpi?

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

### Can LuumenAI change things in Simplekpi on its own?

For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

### Is there an audit trail?

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

Full page: https://www.luumen.ai/integrations/simplekpi/