[Integrations](https://spiral.ai/integrations) › [Hermes](https://spiral.ai/integrations/hermes) › [GovInfo document details](https://spiral.ai/integrations/hermes/govinfo-document-details)

# How to Use GovInfo document details in Hermes

Returns metadata and available document links for a GovInfo publication or section. Use it to check a document's identity and publication context before reading or citing its text.

|  |  |
| --- | --- |
| Model | GovInfo document details |
| 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 document details in Hermes

- Every quarter, use GovInfo document details and GovInfo document text for https://www.govinfo.gov/app/details/PLAW-115publ334. Compare the returned metadata and text with the previous run and report differences separately.
- Every Monday at 9am: use GovInfo document details to look this up and give me the result as a table.
- Pull the latest numbers from GovInfo document details and tell me what changed since last week.
- Check GovInfo document details and summarize what you find in three bullet points.
- Pull the newest data from GovInfo document details and give me the result as a table.

## How to set up GovInfo document details in Hermes

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

### Use the Spiral skill

1. **Send Hermes 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. **Add the server and sign in**: Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

```bash
hermes mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --auth oauth \
  --connect-timeout 300
```

2. **Check it**: In a chat that was already open, run `/reload-mcp`.

```bash
hermes mcp list
hermes mcp test spiral
```

### 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 document details**: 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/document_details",
    "input": {
      "url": "<url>"
    }
  }'
```

Then paste one of the prompts above: Hermes finds GovInfo document details on Spiral, shows the price and runs it.

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

## GovInfo document details tools and prices

- [GovInfo · Document details](https://spiral.ai/tools/alexandria/govinfo-gov/legislation/document_details) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | A govinfo.gov details URL (`/app/details/{package_id}[/{granule_id}]`) instead of the ids. |
| granule_id |  | — | Granule id within the package, e.g. `USCODE-2024-title18-partI-chap110-sec2256`. Pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{1,160}$. |
| package_id |  | — | Package id, e.g. `USCODE-2024-title18`, `PLAW-115publ299`. Pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{1,120}$. |

## What can you do with GovInfo document details in Hermes?

Maintain a federal research digest that reports newly found publications and newly available U.S. Code editions. A scheduled agent can compare GovInfo results with earlier runs and flag documents that need a fresh reading.

### 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.

### Compare statutory wording across editions

Find available editions of a cited section, retrieve the selected texts, and produce a passage-by-passage comparison. Link each passage to its edition and document details.

### 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.

### Find federal publications on a policy topic

Identify relevant publication series, search their metadata and full text, and prepare a reading list with document details and selected passages. Keep the publication series visible so readers can distinguish the sources.

### Review citations in a policy handbook

Resolve the handbook's U.S. Code citations to the intended editions and compare quoted passages with the retrieved text. Return document links and edition information for editorial review.

## Overview

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

## GovInfo document details in other agents

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

## More Hermes guides

- [GovInfo U.S. Code section lookup](https://spiral.ai/integrations/hermes/govinfo-u-s-code-section-lookup)
- [GovInfo document text](https://spiral.ai/integrations/hermes/govinfo-document-text)
- [GovInfo U.S. Code section editions](https://spiral.ai/integrations/hermes/govinfo-u-s-code-section-editions)
- [GovInfo publication collections](https://spiral.ai/integrations/hermes/govinfo-publication-collections)
- [GovInfo U.S. Code browse](https://spiral.ai/integrations/hermes/govinfo-u-s-code-browse)
- [GovInfo publication search](https://spiral.ai/integrations/hermes/govinfo-publication-search)

## Questions about GovInfo document details in Hermes

**Can Hermes use GovInfo document details?**

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run GovInfo document details like any built-in tool.

**How much does GovInfo document details cost in Hermes?**

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

**Do I need an Alexandria account to use GovInfo document details in Hermes?**

No. Spiral runs GovInfo document details 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 document details in Hermes?**

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

**Does Hermes wait while GovInfo document details runs?**

GovInfo document details runs in the background. Hermes 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.

