[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [UNESCO UIS indicator search](https://spiral.ai/integrations/gemini-cli/unesco-uis-indicator-search)

# How to Use UNESCO UIS indicator search in Gemini CLI

Returns matching UIS indicators with information about their available data. Use it to find measures for topics such as primary completion or research spending before examining one indicator's definition.

|  |  |
| --- | --- |
| Model | UNESCO UIS indicator search |
| Available through | Alexandria |
| Category | Public Records |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with UNESCO UIS indicator search in Gemini CLI

- Use UNESCO UIS indicator search to find education measures about primary completion and add a catalog table to this project showing their codes, names, and available time ranges.
- Use UNESCO UIS indicator search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from UNESCO UIS indicator search and tell me what changed since last week.
- Check UNESCO UIS indicator search and summarize what you find in three bullet points.
- Pull the newest data from UNESCO UIS indicator search and give me the result as a table.

## How to set up UNESCO UIS indicator search in Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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 UNESCO UIS indicator search**: 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/indicators",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds UNESCO UIS indicator search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## UNESCO UIS indicator search tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| query |  | — | Whitespace-separated terms; every term must appear in the code or name (case-insensitive). Empty or null lists everything. |
| theme | education, science, culture, demographic, null | — | Restrict to one UIS theme. |
| 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}$. |
| page_size | 1 to 200 | 20 | Records per page (1 to 200). |

## What can you do with UNESCO UIS indicator search in Gemini CLI?

Build a country comparison dashboard with UIS observations, geography labels, and indicator definitions. Use published release metadata to document which publication supplies the dashboard's statistics.

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

### Choose measures for an education dashboard

Find completion and literacy indicators, then inspect their definitions, disaggregations, and available time ranges before deciding which measures belong on the dashboard.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## UNESCO UIS indicator search in other agents

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

## More Gemini CLI guides

- [UNESCO UIS indicator definitions](https://spiral.ai/integrations/gemini-cli/unesco-uis-indicator-definitions)
- [UNESCO UIS statistical data](https://spiral.ai/integrations/gemini-cli/unesco-uis-statistical-data)
- [UNESCO UIS data releases](https://spiral.ai/integrations/gemini-cli/unesco-uis-data-releases)
- [USDOT NAD address points](https://spiral.ai/integrations/gemini-cli/usdot-nad-address-points)
- [UNESCO UIS country and region codes](https://spiral.ai/integrations/gemini-cli/unesco-uis-country-and-region-codes)
- [USDOT NAD release status](https://spiral.ai/integrations/gemini-cli/usdot-nad-release-status)

## Questions about UNESCO UIS indicator search in Gemini CLI

**Can Gemini CLI use UNESCO UIS indicator search?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run UNESCO UIS indicator search like any built-in tool.

**How much does UNESCO UIS indicator search cost in Gemini CLI?**

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

**Do I need an Alexandria account to use UNESCO UIS indicator search in Gemini CLI?**

No. Spiral runs UNESCO UIS indicator search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up UNESCO UIS indicator search in Gemini CLI?**

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

**Does Gemini CLI wait while UNESCO UIS indicator search runs?**

UNESCO UIS indicator search runs in the background. Gemini CLI 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.

