[Integrations](https://spiral.ai/integrations) › [Instinct](https://spiral.ai/integrations/instinct) › [UNGM tender search](https://spiral.ai/integrations/instinct/ungm-tender-search)

# How to Use UNGM tender search in Instinct

Find UNGM procurement notices with titles, organizations, references, publication dates, deadlines, and beneficiary countries. Use it to shortlist opportunities before reading their full requirements.

|  |  |
| --- | --- |
| Model | UNGM tender search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with UNGM tender search in Instinct

- Each weekday, use UNGM tender search for UNICEF refrigeration opportunities benefiting Kenya, and flag results with deadlines in the next 14 days.
- Every Monday at 9am: use UNGM tender search to look this up and give me the result as a table.
- Pull the latest numbers from UNGM tender search and tell me what changed since last week.
- Check UNGM tender search and summarize what you find in three bullet points.
- Pull the newest data from UNGM tender search and give me the result as a table.

## How to set up UNGM tender search 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 UNGM tender 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": "ungm-org/public-tenders/search_notices",
    "input": {
      "page": 1
    }
  }'
```

Then paste one of the prompts above: Instinct finds UNGM tender search on Spiral, shows the price and runs it.

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

## UNGM tender search tools and prices

- [UN Global Marketplace · Search notices](https://spiral.ai/tools/alexandria/ungm-org/public-tenders/search_notices) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 1000 | 1 | 1-based page of 15 rows; `next_page` in the output gives the next one. |
| sort | deadline_asc, deadline_desc, published_desc, published_asc | deadline_asc | Sort order. Default: soonest deadline first, as on the site. |
| title |  | — | Text the notice title must contain (the site's Title filter). |
| agencies |  | — | Publishing UN organizations: an abbreviation as shown on UNGM (`UNDP`, `UNICEF`, `WFP`, case-insensitive) or a numeric UNGM agency id (`1` = UNDP). Resolved against the search page's organization list; an unknown value is invalid_input. |
| countries |  | — | Beneficiary countries or territories: the English name as listed on UNGM (`Kenya`, `Lao People's Democratic Republic`, case-insensitive) or a numeric UNGM country id (`2403`). An unknown value is invalid_input. |
| reference |  | — | Agency reference text, e.g. `UNDP-LAO-00748`. |

## What can you do with UNGM tender search in Instinct?

Keep a procurement watch focused on UNGM categories, opportunity deadlines, and published awards. A scheduled agent can repeat targeted checks and flag records that need review, subject to UNGM's reuse restrictions.

### Assess solar equipment procurement

Find solar equipment categories, review matching notices, and examine published awards to compare requested systems with previously procured equipment.

### Research cold chain requirements

Identify refrigeration categories, read relevant tender descriptions, and examine past awards for the equipment, suppliers, and beneficiary countries reported.

### Compare water supply equipment needs

Map pumps and water supply equipment to procurement categories, compare current notice scopes, and inspect earlier awards for comparable purchases.

### Prepare for freight tenders

Identify freight service categories, shortlist relevant notices, and compare their descriptions with published logistics awards before deciding which opportunities merit a closer review.

### Prioritize approaching deadlines

Shortlist relevant notices by deadline, then read their full descriptions to identify scope requirements that affect whether a response is practical.

## Overview

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

## UNGM tender search in other agents

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

## More Instinct guides

- [UNGM tender notice details](https://spiral.ai/integrations/instinct/ungm-tender-notice-details)
- [US Senate financial disclosure report](https://spiral.ai/integrations/instinct/us-senate-financial-disclosure-report)
- [UNGM procurement category search](https://spiral.ai/integrations/instinct/ungm-procurement-category-search)
- [US Senate financial disclosure search](https://spiral.ai/integrations/instinct/us-senate-financial-disclosure-search)
- [UNGM contract award search](https://spiral.ai/integrations/instinct/ungm-contract-award-search)
- [USAspending agency profile](https://spiral.ai/integrations/instinct/usaspending-agency-profile)

## Questions about UNGM tender search in Instinct

**Can Instinct use UNGM tender search?**

Yes. Add Spiral to Instinct as an MCP server, and Instinct can find and run UNGM tender search like any built-in tool.

**How much does UNGM tender search 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 UNGM tender search in Instinct?**

You need no Alexandria account. Instinct uses one Spiral API key for every tool, and Spiral runs UNGM tender search on its own Alexandria account.

**How long does it take to set up UNGM tender search in Instinct?**

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

**Does Instinct wait while UNGM tender search runs?**

UNGM tender search runs in the background. Instinct starts the run, checks on it and gives you the json when it's ready.

**Does UNGM cover every UN procurement opportunity?**

UNGM reports that 54 UN organizations or UN-affiliated bodies publish procurement notices there. That coverage statement does not establish a complete record of every UN purchase.

**Are UNGM contract awards public and complete?**

Published contract awards are publicly accessible. UNGM says most UN organizations publish awards there, so an absent award does not establish that no contract was awarded.

**How detailed are UNGM's procurement categories?**

UNGM describes its UNSPSC structure as four levels, with two digits per level. The classification lets you distinguish broad categories from more specific products and services.

**How often does UNGM update its category data?**

UNGM says it updates the available UNSPSC categories regularly through a manual process. That statement does not specify a daily or weekly refresh schedule.

**What does a beneficiary country mean?**

It identifies the geographical location of a project's beneficiaries. It does not identify the supplier's home country.

