[Integrations](https://spiral.ai/integrations) › [Hermes](https://spiral.ai/integrations/hermes) › [GLEIF LEI reference record](https://spiral.ai/integrations/hermes/gleif-lei-reference-record)

# How to Use GLEIF LEI reference record in Hermes

Returns a reference record for a legal entity identified by its LEI. Use it to review the legal identity information associated with a known identifier after resolving a company name.

|  |  |
| --- | --- |
| Model | GLEIF LEI reference record |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with GLEIF LEI reference record in Hermes

- Every Monday at 9am: use GLEIF LEI reference record to look this up and give me the result as a table.
- Pull the latest numbers from GLEIF LEI reference record and tell me what changed since last week.
- Check GLEIF LEI reference record and summarize what you find in three bullet points.
- Pull the newest data from GLEIF LEI reference record and give me the result as a table.
- Check GLEIF LEI reference record every morning and tell me only when something changed.

## How to set up GLEIF LEI reference record in Hermes

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Hermes this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Add the server and sign in**: Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

```bash
hermes mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --auth oauth \
  --connect-timeout 300
```

2. **Check it**: In a chat that was already open, run `/reload-mcp`.

```bash
hermes mcp list
hermes mcp test spiral
```

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run GLEIF LEI reference record**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "gleif-org/entities/records_get",
    "input": {
      "lei": "<lei>"
    }
  }'
```

Then paste one of the prompts above: Hermes finds GLEIF LEI reference record on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/hermes

## GLEIF LEI reference record tools and prices

- [GLEIF · Records get](https://spiral.ai/tools/alexandria/gleif-org/entities/records_get) (Alexandria): $0.00873 per call.

## What can you do with GLEIF LEI reference record in Hermes?

Keep a corporate reference dataset aligned with new GLEIF publications. A scheduled agent can check publication status, refresh changed records, and review changes to reported consolidation links.

### Maintain corporate account structures

Resolve customer company names, review their LEI records, and connect reported direct and ultimate parents and children. Use relationship files for larger account portfolios and publication checks and deltas to maintain the results.

### Review supplier concentration

Match supplier names to legal entities and examine which suppliers share a reported ultimate consolidator. Check the consolidator's reported children, inspect direct links, and maintain a portfolio relationship dataset as new publications appear.

### Prepare counterparty research briefs

Identify the contracting legal entity and summarize its reported consolidation structure. Combine individual identity and relationship lookups with a maintained relationship dataset when preparing briefs for many counterparties.

### Review reported corporate restructuring

Compare maintained LEI identities and consolidation links with newly published records. Review affected parents and children to identify changes that warrant investigation, while retaining reporting exceptions.

### Resolve ambiguous company names

Compare candidate LEIs using registered names, addresses, and country of formation before attaching an identifier to a customer or supplier record.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Hermes guides](https://spiral.ai/integrations/hermes)

## GLEIF LEI reference record in other agents

- [Amp](https://spiral.ai/integrations/amp/gleif-lei-reference-record)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/gleif-lei-reference-record)
- [Claude](https://spiral.ai/integrations/claude-desktop/gleif-lei-reference-record)
- [Claude Code](https://spiral.ai/integrations/claude-code/gleif-lei-reference-record)
- [Cline](https://spiral.ai/integrations/cline/gleif-lei-reference-record)
- [Codex](https://spiral.ai/integrations/codex/gleif-lei-reference-record)
- [Cursor](https://spiral.ai/integrations/cursor/gleif-lei-reference-record)
- [Devin](https://spiral.ai/integrations/devin/gleif-lei-reference-record)
- [dots](https://spiral.ai/integrations/dots/gleif-lei-reference-record)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/gleif-lei-reference-record)
- [Gemini](https://spiral.ai/integrations/gemini/gleif-lei-reference-record)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/gleif-lei-reference-record)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/gleif-lei-reference-record)
- [goose](https://spiral.ai/integrations/goose/gleif-lei-reference-record)
- [Grok](https://spiral.ai/integrations/grok/gleif-lei-reference-record)
- [Grok Build](https://spiral.ai/integrations/grok-build/gleif-lei-reference-record)
- [Instinct](https://spiral.ai/integrations/instinct/gleif-lei-reference-record)
- [Manus](https://spiral.ai/integrations/manus/gleif-lei-reference-record)
- [Muse](https://spiral.ai/integrations/muse/gleif-lei-reference-record)
- [Muse Code](https://spiral.ai/integrations/muse-code/gleif-lei-reference-record)
- [n8n](https://spiral.ai/integrations/n8n/gleif-lei-reference-record)
- [Notion](https://spiral.ai/integrations/notion/gleif-lei-reference-record)
- [OpenClaw](https://spiral.ai/integrations/openclaw/gleif-lei-reference-record)
- [opencode](https://spiral.ai/integrations/opencode/gleif-lei-reference-record)
- [Perplexity](https://spiral.ai/integrations/perplexity/gleif-lei-reference-record)
- [Raycast](https://spiral.ai/integrations/raycast/gleif-lei-reference-record)
- [VS Code](https://spiral.ai/integrations/vscode/gleif-lei-reference-record)
- [Windsurf](https://spiral.ai/integrations/windsurf/gleif-lei-reference-record)
- [Zapier](https://spiral.ai/integrations/zapier/gleif-lei-reference-record)

## More Hermes guides

- [GLEIF Golden Copy publication status](https://spiral.ai/integrations/hermes/gleif-golden-copy-publication-status)
- [GLEIF changed records](https://spiral.ai/integrations/hermes/gleif-changed-records)
- [FullEnrich work email lookup](https://spiral.ai/integrations/hermes/fullenrich-work-email-lookup)
- [GLEIF company search](https://spiral.ai/integrations/hermes/gleif-company-search)
- [FullEnrich reverse email lookup](https://spiral.ai/integrations/hermes/fullenrich-reverse-email-lookup)
- [GLEIF direct parent](https://spiral.ai/integrations/hermes/gleif-direct-parent)

## Questions about GLEIF LEI reference record in Hermes

**Can Hermes use GLEIF LEI reference record?**

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run GLEIF LEI reference record like any built-in tool.

**How much does GLEIF LEI reference record cost in Hermes?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Hermes plan is separate.

**Do I need an Alexandria account to use GLEIF LEI reference record in Hermes?**

No. Spiral runs GLEIF LEI reference record on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up GLEIF LEI reference record in Hermes?**

About two minutes: add the server and sign in, then check it.

**Does Hermes wait while GLEIF LEI reference record runs?**

GLEIF LEI reference record runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.

**Does GLEIF cover every company?**

GLEIF covers entities identifiable with an LEI. The Global LEI Index contains historical and current LEI records, so it should not be treated as a census of every registered business.

**How often does GLEIF publish updated files?**

Golden Copy files are published three times daily, at 02:00, 10:00, and 18:00 UTC. That publication schedule is different from the annual revalidation of an entity's reference data.

**Does a parent link identify the beneficial owner?**

GLEIF's direct and ultimate parent links use accounting consolidation. The direct parent is the lowest consolidating entity, while the ultimate parent is the highest consolidating entity.

**Why can parent information be missing?**

GLEIF records reporting exceptions for situations such as a parent without an LEI or exceptional non-disclosure. Its relationship records cover parents with LEIs, so an absent link does not prove that an entity has no parent.

**What period do change files cover?**

GLEIF supplies delta windows of eight hours, 24 hours, seven days, and 31 days. The files contain the latest versions of changed records, so they do not preserve every intermediate edit.

