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

# Metaphor integration for LuumenAI

Pull the full text behind Metaphor search results, without leaving the terminal

## What LuumenAI can do with Metaphor

LuumenAI connects to Metaphor with an API token and exposes 1 tools (1 read-only). Every tool is read-only, so it can answer questions from Metaphor but cannot change anything in it.

## Key facts

- Authentication: API token
- Tools available: 1 tools (1 read-only)
- Plan: available on all plans
- Category: AI & automation

## About Metaphor with LuumenAI

Connect Metaphor and Luumen can fetch the documents behind a search result. METAPHOR_GET_CONTENTS returns parsed text, HTML, and metadata for a set of document IDs, so an incident write-up or a vendor advisory is read in place rather than copied from a browser tab. Read-only, with an API key.

## Example tools

Read-only (1 in total):

- `METAPHOR_GET_CONTENTS` — Retrieve parsed HTML/text contents and metadata for documents by their IDs." Use when you need to fetch the full text and metadata of multiple documents at once.

## Frequently asked questions

### How does LuumenAI connect to Metaphor?

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

No. Every one of the 1 tools is read-only, so LuumenAI can answer questions from Metaphor but cannot change anything in it.

### Is there an audit trail?

Every call to Metaphor is recorded with the actor, the input, and the result.

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