---
title: "BrainGraph integration for LuumenAI"
url: "https://www.luumen.ai/integrations/braingraph/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# BrainGraph integration for LuumenAI

Search your knowledge graph, and add new source material as an approved step

## What LuumenAI can do with BrainGraph

LuumenAI connects to BrainGraph with an API token and exposes 10 tools (6 read-only · 4 write). 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 (6 read-only · 4 write)
- Plan: available on all plans
- Category: AI & automation

## About BrainGraph with LuumenAI

Connect BrainGraph and your team's runbooks, postmortems, vendor docs, and recorded calls become something the agent can query mid-incident. Ask a question in plain language and get facts back with their sources. When new material should join the graph, the agent queues the ingestion as a previewed step you approve first.

## Example tools

Read-only (6 in total):

- `BRAIN_GRAPH_GET_DOCUMENT_PROGRESS` — Get the current transcription, processing, and analysis status for a BrainGraph document.
- `BRAIN_GRAPH_LIST_BRAINS` — List the connected BrainGraph account's knowledge brains and identify the default brain for filtering or targeting other tools.
- `BRAIN_GRAPH_LIST_DOCUMENTS` — List BrainGraph documents newest first, optionally filtering by filename or notes, failed ingestion status, and brain.
- `BRAIN_GRAPH_LIST_PATTERNS` — Find recurring relationship-chain patterns in the connected BrainGraph knowledge graph, subject to a minimum occurrence count.
- `BRAIN_GRAPH_RESOLVE_ENTITY` — Resolve an entity name to a canonical BrainGraph record.
- `BRAIN_GRAPH_SEARCH_BRAIN` — Search facts in the connected account's BrainGraph knowledge graph using a natural-language question, optionally restricted to selected brains.

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

- `BRAIN_GRAPH_INGEST_WEB_PAGE` — Fetch readable content from a public web page and queue it for BrainGraph ingestion.
- `BRAIN_GRAPH_INGEST_YOUTUBE_VIDEO` — Submit a YouTube video for metadata, transcript, and speaker processing; the result may only confirm that processing was queued.
- `BRAIN_GRAPH_TRANSCRIBE_AUDIO` — Upload an audio file or submit a direct public audio URL for diarized transcription and graph ingestion.
- `BRAIN_GRAPH_UPLOAD_DOCUMENT` — Upload a document file supplied by the caller or plain text and queue it for BrainGraph ingestion.

## Frequently asked questions

### How does LuumenAI connect to BrainGraph?

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 BrainGraph on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default. Administrators configure that per tool.

### Is there an audit trail?

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

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