[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [UNESCO UIS statistical data](https://spiral.ai/integrations/instinct/unesco-uis-statistical-data)

# How to Use UNESCO UIS statistical data in Instinct

Returns UNESCO UIS observations by indicator, country or region, and year, with supporting metadata and footnotes when requested. Use it to compare education, research, or heritage statistics after choosing the right measure.

|  |  |
| --- | --- |
| Model | UNESCO UIS statistical data |
| Available through | Alexandria |
| Category | Public Records |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with UNESCO UIS statistical data in Instinct

- Each month, use UNESCO UIS statistical data to check available primary completion observations for Kenya from 2015 onward and report values or source notes that differ from your previous check.
- Every Monday at 9am: use UNESCO UIS statistical data to look this up and give me the result as a table.
- Pull the latest numbers from UNESCO UIS statistical data and tell me what changed since last week.
- Check UNESCO UIS statistical data and summarize what you find in three bullet points.
- Pull the newest data from UNESCO UIS statistical data and give me the result as a table.

## How to set up UNESCO UIS statistical data in Instinct

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

### Use the Spiral skill

1. **Send Instinct 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. **Create an API key**: In the console, open API keys and create a key for Instinct. Copy it.

2. **Send Instinct this message**: Instinct reads Spiral's skill and asks for your API key.

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

3. **Give Instinct the key**: When Instinct asks for the key, add it where Instinct keeps secrets, never in the chat itself.

### 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 UNESCO UIS statistical data**: 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": "databrowser-uis-unesco-org/statistics/data",
    "input": {
      "indicator_codes": [
        "<indicator_codes>"
      ]
    }
  }'
```

Then paste one of the prompts above: Instinct finds UNESCO UIS statistical data on Spiral, shows the price and runs it.

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

## UNESCO UIS statistical data tools and prices

- [UNESCO UIS · Data](https://spiral.ai/tools/alexandria/databrowser-uis-unesco-org/statistics/data) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| end | 1900 to 2100 | — | Last year, inclusive. |
| start | 1900 to 2100 | — | First year, inclusive. |
| cursor |  | — | Opaque next_cursor from the previous page of the same query. null or omitted = first page. |
| version |  | — | UIS data version id such as 20260507-91260335 (see versions). null or omitted = current default version. Pattern: ^[0-9]{8}-[0-9a-fA-F]{8}$. |
| geo_units |  | — | ISO3 country codes and/or region ids such as `SDG: Sub-Saharan Africa`. Empty = every geo unit (combine with geo_unit_type). |
| page_size | 1 to 1000 | 100 | Records per page (1 to 1000). |

## What can you do with UNESCO UIS statistical data in Instinct?

Keep a UIS country comparison brief current as new publications become available. Check release information, indicator availability, definitions, geography records, and observations for changes relevant to the brief.

### Compare primary completion across East Africa

Build a Kenya, Tanzania, and Uganda comparison by finding primary completion measures, checking their definitions, resolving country codes, selecting a release, and retrieving the available observations.

### Prepare a research spending comparison

Find research expenditure measures for Brazil, Mexico, and Chile, check the calculation methods and available years, identify the country codes, and use a selected release for the comparison.

### Research heritage preservation spending

Find cultural and natural heritage expenditure indicators for France, Spain, and Portugal. Check definitions and availability, resolve the countries, and retrieve the observations from one selected release.

### Reproduce a published education comparison

Rebuild an India and Bangladesh education table using a documented release, confirmed geography codes, matching indicator definitions, and the corresponding observations. Check catalog availability before choosing the comparison period.

### Explain a country trend with its source notes

Retrieve Brazil's available primary completion observations and examine their footnotes alongside the indicator definition. Write a trend explanation that reflects the measure's stated method and limitations.

## Overview

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

## UNESCO UIS statistical data in other agents

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

## More Instinct guides

- [UNESCO UIS indicator search](https://spiral.ai/integrations/instinct/unesco-uis-indicator-search)
- [USDOT NAD address points](https://spiral.ai/integrations/instinct/usdot-nad-address-points)
- [UNESCO UIS indicator definitions](https://spiral.ai/integrations/instinct/unesco-uis-indicator-definitions)
- [USDOT NAD release status](https://spiral.ai/integrations/instinct/usdot-nad-release-status)
- [UNESCO UIS data releases](https://spiral.ai/integrations/instinct/unesco-uis-data-releases)
- [USGS earthquake details](https://spiral.ai/integrations/instinct/usgs-earthquake-details)

## Questions about UNESCO UIS statistical data in Instinct

**Can Instinct use UNESCO UIS statistical data?**

Yes. Add Spiral to Instinct as an MCP server, and Instinct can find and run UNESCO UIS statistical data like any built-in tool.

**How much does UNESCO UIS statistical data cost in Instinct?**

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

**Do I need an Alexandria account to use UNESCO UIS statistical data in Instinct?**

You need no Alexandria account. Instinct uses one Spiral API key for every tool, and Spiral runs UNESCO UIS statistical data on its own Alexandria account.

**How long does it take to set up UNESCO UIS statistical data in Instinct?**

About two minutes: create an API key, then send Instinct this message, then give Instinct the key.

**Does Instinct wait while UNESCO UIS statistical data runs?**

UNESCO UIS statistical data runs in the background. Instinct starts the run, checks on it and gives you the json when it's ready.

**What subjects does UNESCO UIS cover?**

UIS publishes internationally comparable statistics on education, science, culture, and communication. Its indicator metadata identifies the theme and available time range for a particular measure.

**Does every indicator cover every country?**

The November 2026 education release covers 240 countries and territories overall. Each indicator has its own availability information, so that total should not be read as complete coverage for every measure.

**How often does UIS update education statistics?**

Beginning in 2026, the main education release is scheduled for November, followed by a refresh in May of the subsequent year. Check the indicator's last data update and available years when choosing a series.

**How far back do the statistics go?**

UIS reports a time range for each indicator rather than one history window for the entire catalog. Inspect that range for the measure you need before requesting a historical comparison.

**How can I check whether two statistics are comparable?**

UIS methodological metadata includes the calculation method, data sources, disaggregations, quality assurance, and limitations. Use those details to check that the measures use compatible definitions and populations.

