[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [GovInfo U.S. Code browse](https://spiral.ai/integrations/codex/govinfo-u-s-code-browse)

# How to Use GovInfo U.S. Code browse in Codex

Returns the U.S. Code's structure within an edition, from titles down to sections. Use it to explore neighboring provisions and find document locations without a keyword search.

|  |  |
| --- | --- |
| Model | GovInfo U.S. Code browse |
| 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 GovInfo U.S. Code browse in Codex

- Use GovInfo U.S. Code browse to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from GovInfo U.S. Code browse and tell me what changed since last week.
- Check GovInfo U.S. Code browse and summarize what you find in three bullet points.
- Pull the newest data from GovInfo U.S. Code browse and give me the result as a table.
- Check GovInfo U.S. Code browse every morning and tell me only when something changed.

## How to set up GovInfo U.S. Code browse in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 GovInfo U.S. Code browse**: 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": "govinfo-gov/legislation/browse_collection",
    "input": {
      "collection": "<collection>"
    }
  }'
```

Then paste one of the prompts above: Codex finds GovInfo U.S. Code browse on Spiral, shows the price and runs it.

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

## GovInfo U.S. Code browse tools and prices

- [GovInfo · Browse collection](https://spiral.ai/tools/alexandria/govinfo-gov/legislation/browse_collection) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| path |  | — | `browse_path` of a node returned by the previous level, e.g. `2024/title18/partI`. Pattern: ^[A-Za-z0-9._-]+(/[A-Za-z0-9._-]+)*$. |

## What can you do with GovInfo U.S. Code browse in Codex?

Build a federal publication reader with U.S. Code navigation, source text, and edition comparisons. A coding agent can use GovInfo documents to populate the interface and connect each passage to its publication metadata.

### Build a federal statute research reader

Create a reader that starts with publication selection, lets researchers explore the U.S. Code, and opens cited sections with their metadata and text. Add edition selection for historical comparisons and topic search for discovery.

### Prepare a legislative research packet

Choose publication series, find documents about a policy topic, and organize the relevant U.S. Code provisions by chapter. Include document metadata, readable text, and selected historical editions for a reviewer.

### Create a federal legal research lesson

Build an exercise around a public statute: identify its publication collection, locate its chapter, search for related publications, and retrieve a cited section. Have students compare selected editions and distinguish document metadata from document text.

### Assemble an edition-specific reference archive

Select federal publication collections and collect the documents needed for a policy handbook. Organize U.S. Code sections within their titles, preserve publication metadata and text, and include earlier editions where the handbook discusses changes.

### Map a U.S. Code chapter

Walk a chapter's structure and assemble its section headings, document locations, and text into a navigable reading list. Use the map to examine neighboring provisions that a keyword search might miss.

## Overview

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

## GovInfo U.S. Code browse in other agents

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

## More Codex guides

- [Gov.br page content](https://spiral.ai/integrations/codex/gov-br-page-content)
- [GovInfo U.S. Code section editions](https://spiral.ai/integrations/codex/govinfo-u-s-code-section-editions)
- [Gov.br agency news](https://spiral.ai/integrations/codex/gov-br-agency-news)
- [GovInfo U.S. Code section lookup](https://spiral.ai/integrations/codex/govinfo-u-s-code-section-lookup)
- [Gov.br agency directory](https://spiral.ai/integrations/codex/gov-br-agency-directory)
- [GovInfo document details](https://spiral.ai/integrations/codex/govinfo-document-details)

## Questions about GovInfo U.S. Code browse in Codex

**Can Codex use GovInfo U.S. Code browse?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run GovInfo U.S. Code browse like any built-in tool.

**How much does GovInfo U.S. Code browse cost in Codex?**

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

**Do I need an Alexandria account to use GovInfo U.S. Code browse in Codex?**

No. Spiral runs GovInfo U.S. Code browse on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up GovInfo U.S. Code browse in Codex?**

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

**Does Codex wait while GovInfo U.S. Code browse runs?**

GovInfo U.S. Code browse runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**Does GovInfo include every government document?**

GovInfo covers official publications from all three branches of the federal government. Its search only includes documents stored on GovInfo, so it is not a complete index of everything government agencies publish.

**How far back does GovInfo's U.S. Code archive go?**

GovInfo provides virtual main editions of the U.S. Code from 1994 onward. You can browse them by year and then title.

**How often is the U.S. Code updated?**

The publication cycle includes a new main edition every six years and annual supplements. A GovInfo edition is a published snapshot, so choose the edition deliberately when comparing statutory wording.

**Does a recent modification date mean a publication is new?**

GovInfo's lastModified value records when a package was added or updated. It differs from the publication date, so a recent modification alone does not establish when the document was issued.

**Is every document available in the same formats?**

Most GovInfo documents are available as PDF and text. Other formats depend on the publication, and the document details page identifies the available files.

