[Integrations](https://spiral.ai/integrations) › [Amp](https://spiral.ai/integrations/amp) › [gpt-oss-20b](https://spiral.ai/integrations/amp/gpt-oss-20b)

# How to Use gpt-oss-20b in Amp

gpt-oss-20b handles coding, reasoning, and tool-assisted text tasks. OpenAI positions it for lower latency and specialized work, while gpt-oss-120b targets more demanding reasoning.

|  |  |
| --- | --- |
| Model | gpt-oss-20b |
| Available through | OpenRouter |
| Category | LLM |
| Price | Up to $0.000695 per run at the default inputs. $0.039 per 1M input tokens, $0.169 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with gpt-oss-20b in Amp

- Use gpt-oss-20b with high reasoning effort to investigate the failing tests in this project. Read the relevant implementation, reproduce one failure, and make the smallest fix with a regression test.
- Use gpt-oss-20b to review the current diff for logic errors and missing edge cases. Cite file locations, explain each issue's trigger, and omit style-only suggestions.
- Use gpt-oss-20b to inspect this project's text-parsing code. Add tests for empty input, malformed records, and unexpected Unicode, then report which tests expose a bug.
- Use gpt-oss-20b with medium reasoning effort to trace how a request moves through this repository. Explain the main functions and error paths, citing the files you read.
- Use gpt-oss-20b to examine the JSON records produced by this project. Propose validation rules, add checks for missing required values, and test them against representative records.

## How to set up gpt-oss-20b in Amp

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

### Use Spiral's MCP server

1. **Add the server**: No header and no client ID or secret: Amp registers itself with Spiral.

```bash
amp mcp add spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `amp`. Amp opens Spiral's sign-in page in your browser: sign in, pick the organization and click Authorize. No API key.

3. **Check it**

```bash
amp mcp doctor
```

### Use the Spiral skill

1. **Send Amp 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 gpt-oss-20b**: 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": "openrouter",
    "model": "openai/gpt-oss-20b",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

Then paste one of the prompts above: Amp finds gpt-oss-20b on Spiral, shows the price and runs it.

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

## gpt-oss-20b tools and prices

- [OpenAI: gpt-oss-20b](https://spiral.ai/tools/openrouter/openai/gpt-oss-20b) (OpenRouter): Up to $0.013037 per run at the default inputs. $0.0221 per 1M input tokens, $0.1105 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| seed |  | — |  |
| stop |  | — |  |
| min_p | 0 to 1 | — |  |
| tools |  | — |  |
| top_k | 0 to … | — |  |
| top_p | 0 to 1 | — |  |

## What can you do with gpt-oss-20b in Amp?

gpt-oss-20b can help turn project code and test failures into focused fixes and review findings. Give it the relevant files, a concrete success condition, and tests that can check the result.

### Debug a failing test

Give gpt-oss-20b the failure output and relevant code. Ask for a minimal fix and a regression test that reproduces the problem.

### Review a code change

Ask gpt-oss-20b to inspect a diff for logic errors, missed edge cases, and assumptions that need tests.

### Extract structured records

Turn support messages or intake text into JSON records. Specify the required keys and use null for information the source does not contain.

### Explain technical material

Provide a technical passage and ask gpt-oss-20b to explain its assumptions, define unfamiliar terms, and work through a small example.

### Check a quantitative argument

Ask gpt-oss-20b to examine units, assumptions, and calculations in a proposed solution. Use an available Python tool to verify the arithmetic.

### Draft answers from reference text

Supply policy or product documentation and ask for answers with supporting passages. Require an explicit unknown when the text does not answer the question.

### Triage recurring operational reports

Use gpt-oss-20b to classify supplied incident summaries, identify repeated symptoms, and propose the next diagnostic question for each unresolved issue.

## Overview

- [OpenRouter](https://spiral.ai/providers/openrouter)
- [All Amp guides](https://spiral.ai/integrations/amp)

## gpt-oss-20b in other agents

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

## More Amp guides

- [Weaver Alpha](https://spiral.ai/integrations/amp/weaver-alpha)
- [o3](https://spiral.ai/integrations/amp/o3)
- [Voxtral Small 24B](https://spiral.ai/integrations/amp/voxtral-small-24b)
- [o3-pro](https://spiral.ai/integrations/amp/o3-pro)
- [Venice Uncensored](https://spiral.ai/integrations/amp/venice-uncensored)
- [AI Ark company search](https://spiral.ai/integrations/amp/ai-ark-company-search)

## Questions about gpt-oss-20b in Amp

**Can Amp use gpt-oss-20b?**

Yes. Add Spiral to Amp as an MCP server, and Amp can find and run gpt-oss-20b like any built-in tool.

**How much does gpt-oss-20b cost in Amp?**

Up to $0.000695 per run at the default inputs. $0.039 per 1M input tokens, $0.169 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Amp plan is separate.

**Do I need an OpenRouter account to use gpt-oss-20b in Amp?**

No. Spiral runs gpt-oss-20b on its own OpenRouter account. You sign in to Spiral once and never paste a key.

**How long does it take to set up gpt-oss-20b in Amp?**

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

**Does Amp wait while gpt-oss-20b runs?**

gpt-oss-20b runs in the background. Amp starts the run, checks on it and gives you the text, json when it's ready.

**What is gpt-oss-20b good at?**

Coding, reasoning, and tasks that combine text with tool calls are its clearest fits. Try focused bug fixes, technical explanations, and extracting structured records from supplied text.

**How much text can gpt-oss-20b handle?**

OpenAI lists a 131,072-token context window and a maximum output of 131,072 tokens. Treat those as model specifications, rather than a target length for every answer.

**Can gpt-oss-20b understand screenshots or recordings?**

It processes text only. For a screenshot or recording, provide extracted text or a transcript and ask questions about that text.

**Which reasoning level should I choose?**

Start with low effort for straightforward dialogue and medium for everyday analysis. Try high effort for difficult debugging or multistep problems, then compare results on representative tasks.

**Which languages should I use with gpt-oss-20b?**

Its training data was mostly English, with an emphasis on STEM, coding, and general knowledge. For another language, test examples from your actual task before relying on the results.

