[Integrations](https://spiral.ai/integrations) › [Amp](https://spiral.ai/integrations/amp) › [o3](https://spiral.ai/integrations/amp/o3)

# How to Use o3 in Amp

Use o3 to debug difficult code, solve math problems, and interpret charts. Compared with o3-pro, it suits complex work that does not need the extra deliberation aimed at more reliable answers.

|  |  |
| --- | --- |
| Model | o3 |
| Available through | OpenAI |
| Category | LLM |
| Price | Up to $0.04269 per run at the default inputs. $2.60 per 1M input tokens, $0.65 per 1M cached input tokens, $10.40 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with o3 in Amp

- Use o3 to investigate the failing tests in this project. Inspect the relevant code, identify the likely cause, and propose the smallest patch with a regression test.
- Use o3 to compare the implementation with the requirements in this repository. Report concrete mismatches, the affected files, and a test that would expose each mismatch.
- Use o3 to plan the refactor described in the issue. Inspect project dependencies and propose an ordered sequence of changes, with a verification checkpoint after each change.
- Ask o3 through Spiral to review the diff on this branch and list the three riskiest changes. Save the result in ./assets.
- Get a second opinion from o3 on this function, then tell me what the call cost.

## How to set up o3 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 o3**: 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": "openai",
    "model": "openai/o3",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

Then paste one of the prompts above: Amp finds o3 on Spiral, shows the price and runs it.

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

## o3 tools and prices

- [o3](https://spiral.ai/tools/openai/openai/o3) (OpenAI): Up to $0.04269 per run at the default inputs. $2.60 per 1M input tokens, $0.65 per 1M cached input tokens, $10.40 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| seed |  | — |  |
| tools |  | — |  |
| reasoning |  | — | Reasoning effort; reasoning tokens count toward max_tokens. |
| max_tokens | 16 to 100000 | — | The most output tokens to generate. |
| tool_choice |  | — |  |
| response_format |  | — |  |

## What can you do with o3 in Amp?

OpenAI o3 can help turn a difficult bug or design question into a concrete patch or implementation plan. Give it relevant project code, constraints, and test results, then request a result you can verify.

### Investigate a difficult bug

Give OpenAI o3 the failing behavior, relevant code, and test results. Ask for a likely cause, a minimal fix, and a regression test that demonstrates the problem.

### Review a database migration

Have OpenAI o3 compare a proposed migration with its requirements. Request failure scenarios, data consistency checks, and a rollback plan.

### Check a mathematical solution

Supply the problem and proposed answer to OpenAI o3. Ask it to identify invalid assumptions, check boundary cases, and return a corrected solution when needed.

### Compare scientific explanations

Give OpenAI o3 observations and competing hypotheses. Request the evidence for each explanation and an experiment that could distinguish them.

### Interpret a chart

Provide OpenAI o3 with a chart image and its surrounding context. Ask for the main trend, supporting observations, and claims the chart does not establish.

### Compare conflicting requirements

Ask OpenAI o3 to reconcile supplied specifications or policy excerpts. Request the conflicting passages, their practical consequences, and the decisions still needed.

### Plan a complicated project

Give OpenAI o3 the goal, constraints, and dependencies. Ask for an ordered plan with checkpoints and explicit conditions for moving to the next task.

### Find evidence across long source material

Provide OpenAI o3 with labeled source excerpts and a specific question. Ask it to extract relevant passages and distinguish documented conclusions from unresolved questions.

## Overview

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

## o3 in other agents

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

## More Amp guides

- [gpt-oss-20b](https://spiral.ai/integrations/amp/gpt-oss-20b)
- [o3-pro](https://spiral.ai/integrations/amp/o3-pro)
- [Weaver Alpha](https://spiral.ai/integrations/amp/weaver-alpha)
- [AI Ark company search](https://spiral.ai/integrations/amp/ai-ark-company-search)
- [Voxtral Small 24B](https://spiral.ai/integrations/amp/voxtral-small-24b)
- [AI Ark personality insights](https://spiral.ai/integrations/amp/ai-ark-personality-insights)

## Questions about o3 in Amp

**Can Amp use o3?**

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

**How much does o3 cost in Amp?**

Up to $0.04269 per run at the default inputs. $2.60 per 1M input tokens, $0.65 per 1M cached input tokens, $10.40 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 OpenAI account to use o3 in Amp?**

No. Spiral runs o3 on its own OpenAI account. You sign in to Spiral once and never paste a key.

**How long does it take to set up o3 in Amp?**

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

**Does Amp wait while o3 runs?**

o3 runs in the background. Amp starts the run, checks on it and gives you the text, json when it's ready.

**What is OpenAI o3 good at?**

OpenAI o3 is suited to difficult coding, math, science, and visual analysis. Useful tasks include investigating a bug, checking a calculation, or interpreting a chart alongside its supporting explanation.

**How does o3-pro differ from o3?**

o3-pro uses o3 as its underlying model and thinks longer to produce more reliable responses. Choose it for a difficult question where you want additional deliberation.

**How much material can OpenAI o3 handle?**

o3 and o3-pro each have a 200,000-token context window and a maximum output allowance of 100,000 tokens. Internal reasoning also uses generated tokens, so that allowance does not mean 100,000 tokens of readable text.

**How should I prompt OpenAI o3?**

Use brief, direct instructions. State the question, provide the relevant evidence, and specify the final result you need, such as a patch, comparison table, or short recommendation.

**Does OpenAI o3 know about recent events?**

o3 and o3-pro have a June 1, 2024 knowledge cutoff. For later events, provide dated source material and ask the model to base its answer on that evidence.

