[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [GLEIF changed records](https://spiral.ai/integrations/windsurf/gleif-changed-records)

# How to Use GLEIF changed records in Windsurf

Returns records from a Golden Copy delta covering identity data, relationships, or reporting exceptions. Use it to refresh an existing dataset; each changed record contains its latest version rather than every intermediate edit.

|  |  |
| --- | --- |
| Model | GLEIF changed records |
| 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 changed records in Windsurf

- Use GLEIF changed records to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from GLEIF changed records and tell me what changed since last week.
- Check GLEIF changed records and summarize what you find in three bullet points.
- Pull the newest data from GLEIF changed records and give me the result as a table.
- Check GLEIF changed records every morning and tell me only when something changed.

## How to set up GLEIF changed records in Windsurf

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

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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 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 changed records**: 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_changes",
    "input": {
      "delta": "IntraDay",
      "filetype": "lei2"
    }
  }'
```

Then paste one of the prompts above: Windsurf finds GLEIF changed records on Spiral, shows the price and runs it.

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

## GLEIF changed records tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| cursor |  | — | Opaque continuation from the previous page (pins publication, file, ETag and row offset). |
| page_size | 1 to 5000 | 200 | page_size |
| publication_id |  | — | Pin an explicit publication (YYYYMMDD-HHMM, e.g. 20261017-1600). Default: latest. Pattern: ^[0-9]{8}-[0-9]{4}$. |

## What can you do with GLEIF changed records in Windsurf?

Build a company reference table and reported consolidation chart inside your project. A coding agent can join LEI identities to parent and child relationships while keeping reporting exceptions visible.

### 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.

### Refresh a relationship database

Start with current relationship records, check for new Golden Copy publications, and apply subsequent deltas. Use the latest changed records to update stored relationships.

### Explain gaps in parent reporting

Review direct and ultimate parent responses and their reporting exceptions. Distinguish an unavailable parent identifier or non-disclosure from a reported absence of an accounting-consolidating parent.

## Overview

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

## GLEIF changed records in other agents

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

## More Windsurf guides

- [GLEIF LEI reference record](https://spiral.ai/integrations/windsurf/gleif-lei-reference-record)
- [GLEIF company search](https://spiral.ai/integrations/windsurf/gleif-company-search)
- [GLEIF Golden Copy publication status](https://spiral.ai/integrations/windsurf/gleif-golden-copy-publication-status)
- [GLEIF direct parent](https://spiral.ai/integrations/windsurf/gleif-direct-parent)
- [FullEnrich work email lookup](https://spiral.ai/integrations/windsurf/fullenrich-work-email-lookup)
- [GLEIF direct subsidiaries](https://spiral.ai/integrations/windsurf/gleif-direct-subsidiaries)

## Questions about GLEIF changed records in Windsurf

**Can Windsurf use GLEIF changed records?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run GLEIF changed records like any built-in tool.

**How much does GLEIF changed records cost in Windsurf?**

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

**Do I need an Alexandria account to use GLEIF changed records in Windsurf?**

No. Spiral runs GLEIF changed records 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 changed records in Windsurf?**

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

**Does Windsurf wait while GLEIF changed records runs?**

GLEIF changed records runs in the background. Windsurf 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.

