[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [TED tender search](https://spiral.ai/integrations/windsurf/ted-tender-search)

# How to Use TED tender search in Windsurf

Returns matching published TED procurement notices for a buyer, sector or publication period. Use it to build an opportunity shortlist or research past awards before examining individual notices.

|  |  |
| --- | --- |
| Model | TED tender 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 TED tender search in Windsurf

- Use TED tender search to find software service opportunities from public buyers in Germany published in the past 30 days. Add the returned titles, buyers, deadlines and notice links to procurement/opportunities.json.
- Use TED tender search to find contract award notices for Deutsche Bahn published in 2025. Build a table of the returned titles, buyers and publication numbers.
- Use TED tender search to find translation service procurements from public buyers in Belgium published in the past 90 days. Add a review table to our project with notice links and any returned deadlines.
- Use TED tender search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from TED tender search and tell me what changed since last week.

## How to set up TED tender search 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 TED 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": "eu-institutions-law-eur-lex-official/tenders/tenders",
    "input": {
      "cpv": "<cpv>"
    }
  }'
```

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

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

## TED tender search tools and prices

- [EU law and public tenders · Search EU tenders (TED)](https://spiral.ai/tools/alexandria/eu-institutions-law-eur-lex-official/tenders/tenders) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| cpv |  | — | CPV code, e.g. 72000000 (IT services). Pattern: ^[0-9]{8}$. |
| page | 1 to … | 1 | page |
| text |  | — | Words searched in the notice full text (all must match). |
| limit | 1 to 50 | 20 | limit |
| query |  | — | Raw TED expert query, e.g. `buyer-name~("Deutsche Bahn")`; combined with the other filters using AND. |
| scope | active, all | active | scope |

## What can you do with TED tender search in Windsurf?

Build a procurement review table from TED buyer names, lots, deadlines and published award outcomes. A coding agent can turn those records into project data and link each row to its official notice.

### Build a bid shortlist

Find published opportunities in your service sector, then examine each notice's buyer, lots and deadlines to decide which bids deserve attention.

### Choose suitable contract lots

Find relevant procurements and inspect the descriptions of individual lots. Prepare a shortlist of the lots that match your company's services.

### Plan submission work

Collect submission deadlines and procurement document links for selected opportunities. Turn the published requirements into a bid team's review queue.

### Research award outcomes

Find contract award notices for a sector or public buyer, then inspect the reported winners and lots to understand previous procurement outcomes.

### Prepare a public buyer brief

Review a public organization's published notices across a defined period. Use notice descriptions, lots and award outcomes to explain what it has procured.

### Publish a procurement digest

Select relevant TED notices and write short summaries with buyer names, deadlines and official notice links for a trade association or sector newsletter.

## Overview

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

## TED tender search in other agents

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

## More Windsurf guides

- [TED tender notice details](https://spiral.ai/integrations/windsurf/ted-tender-notice-details)
- [Taiwan government tender details](https://spiral.ai/integrations/windsurf/taiwan-government-tender-details)
- [Supreme Court of Canada judgment text](https://spiral.ai/integrations/windsurf/supreme-court-of-canada-judgment-text)
- [Taiwan government tender search](https://spiral.ai/integrations/windsurf/taiwan-government-tender-search)
- [Supreme Court of Canada judgment search](https://spiral.ai/integrations/windsurf/supreme-court-of-canada-judgment-search)
- [Taiwan procurement agency lookup](https://spiral.ai/integrations/windsurf/taiwan-procurement-agency-lookup)

## Questions about TED tender search in Windsurf

**Can Windsurf use TED tender search?**

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

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

No. Spiral runs TED tender 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 TED tender search in Windsurf?**

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

**Does Windsurf wait while TED tender search runs?**

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

**Does TED cover procurement outside the European Union?**

Yes. TED describes its coverage as the European Union, the European Economic Area and beyond. That coverage does not mean every country or public purchase is represented.

**How far back can I search TED notices?**

TED's all-notices search covers the last 10 years from the search date. Use that rolling window when planning historical award research.

**How often does TED publish new notices?**

TED publishes more than 3,000 public procurement notices each weekday, Monday through Friday. A weekday review suits this publication cycle.

**Does TED include every public contract?**

EU-wide publication requirements apply above specified contract values. TED therefore should not be used as a complete inventory of all public purchasing, especially smaller contracts.

**Is TED information guaranteed to be complete and accurate?**

No. The Publications Office explicitly says its information is not necessarily comprehensive, complete, accurate or up to date.

