[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [Amtrak route directory](https://spiral.ai/integrations/windsurf/amtrak-route-directory)

# How to Use Amtrak route directory in Windsurf

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 Windsurf

- 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 Windsurf

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

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf 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: Windsurf finds Amtrak route directory on Spiral, shows the price and runs it.

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

## 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 Windsurf?

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 Windsurf guides](https://spiral.ai/integrations/windsurf)

## 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)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/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)
- [Zapier](https://spiral.ai/integrations/zapier/amtrak-route-directory)

## More Windsurf guides

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

## Questions about Amtrak route directory in Windsurf

**Can Windsurf use Amtrak route directory?**

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

**How much does Amtrak route directory cost in Windsurf?**

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

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

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 Windsurf?**

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

**Does Windsurf wait while Amtrak route directory runs?**

Amtrak route directory runs in the background. Windsurf 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.

