[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Amtrak route directory](https://spiral.ai/integrations/gemini-cli/amtrak-route-directory)

# How to Use Amtrak route directory in Gemini CLI

Returns Amtrak’s named routes for route discovery. Use it to find a service before requesting its stops and train numbers or checking trains currently running on it.

|  |  |
| --- | --- |
| Model | Amtrak route directory |
| Available through | Alexandria |
| Category | Maps & Reviews |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Amtrak route directory in Gemini CLI

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

## How to set up Amtrak route directory in Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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 Amtrak route directory**: 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": "amtrak-com/train-status/list_routes",
    "input": {}
  }'
```

Then paste one of the prompts above: Gemini CLI finds Amtrak route directory on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Amtrak route directory tools and prices

- [Amtrak · List routes](https://spiral.ai/tools/alexandria/amtrak-com/train-status/list_routes) (Alexandria): $0.00873 per call.

## What can you do with Amtrak route directory in Gemini CLI?

Build a rail travel view that connects Amtrak station information, route stops, and reported train progress. A coding agent can use these responses to populate the project’s station pages and keep scheduled, estimated, and actual stop times distinct.

### Prepare a route stop guide

Find Coast Starlight in the route directory and retrieve its ordered stops. Browse the station directory, resolve station names through search, and retrieve station details for a practical stop-by-stop reference.

### Prepare station accessibility questions

Discover routes and stops for a proposed rail journey, then browse and search the station listings to identify the intended stations. Use their reported amenities and hours to prepare specific accessibility questions before travel.

### Answer a hotel guest’s rail arrival question

Find the guest’s named route and its stops, then browse nearby Amtrak stations and resolve the arrival station by name. Retrieve its address and amenities to prepare an arrival guide for the front desk.

### Research rail destinations

Browse Amtrak routes and station listings to shortlist places for a rail trip. Inspect route stops, search for the shortlisted stations, and compare their reported hours and amenities before researching dated travel options separately.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Amtrak route directory in other agents

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

## More Gemini CLI guides

- [Amtrak route details](https://spiral.ai/integrations/gemini-cli/amtrak-route-details)
- [Amtrak station details](https://spiral.ai/integrations/gemini-cli/amtrak-station-details)
- [Amtrak live train positions](https://spiral.ai/integrations/gemini-cli/amtrak-live-train-positions)
- [Amtrak station directory](https://spiral.ai/integrations/gemini-cli/amtrak-station-directory)
- [Agoda top destinations](https://spiral.ai/integrations/gemini-cli/agoda-top-destinations)
- [Amtrak station search](https://spiral.ai/integrations/gemini-cli/amtrak-station-search)

## Questions about Amtrak route directory in Gemini CLI

**Can Gemini CLI use Amtrak route directory?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Amtrak route directory like any built-in tool.

**How much does Amtrak route directory cost in Gemini CLI?**

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

**Do I need an Alexandria account to use Amtrak route directory in Gemini CLI?**

No. Spiral runs Amtrak route directory on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Amtrak route directory in Gemini CLI?**

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

**Does Gemini CLI wait while Amtrak route directory runs?**

Amtrak route directory runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**Does the data cover Canadian stops?**

Amtrak says Track Your Train represents its routes, stations, and active trains across the United States and into Canada. That is Amtrak coverage, rather than a directory of every Canadian rail operator.

**Does this include fares or schedules for a future travel date?**

The provider explicitly excludes fares, schedules by date, and booking. A route’s stop list or a currently tracked train’s times cannot establish what is available for a future trip.

**What station information is available?**

The provider documents station addresses, hours, and amenities alongside station discovery. For example, Amtrak lists Chicago Union Station at 255 South Clinton Street.

**What is the difference between route information and train status?**

Route information supplies ordered stops and train numbers for a named service. Train status supplies currently tracked runs with scheduled, estimated, and actual stop times.

**Are reported arrival times actual arrivals?**

The train status data distinguishes scheduled, estimated, and actual times. An estimated arrival is a prediction; use the actual arrival value when describing a stop the train has reached.

