[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [MarineCadastre AIS file list](https://spiral.ai/integrations/opencode/marinecadastre-ais-file-list)

# How to Use MarineCadastre AIS file list in opencode

Returns daily archive file descriptors for a year, tied to a publication hash. Use it to assemble a download manifest for a historical traffic study.

|  |  |
| --- | --- |
| Model | MarineCadastre AIS file list |
| 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 MarineCadastre AIS file list in opencode

- Use MarineCadastre AIS file list to collect the 2024 daily file descriptors for our Savannah Harbor baseline and write a manifest containing dates, URLs, sizes, and checksums.
- Use MarineCadastre AIS file list to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from MarineCadastre AIS file list and tell me what changed since last week.
- Check MarineCadastre AIS file list and summarize what you find in three bullet points.
- Pull the newest data from MarineCadastre AIS file list and give me the result as a table.

## How to set up MarineCadastre AIS file list in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

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

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 MarineCadastre AIS file list**: 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": "marinecadastre-gov/vessel-traffic/records_list",
    "input": {
      "year": 2015
    }
  }'
```

Then paste one of the prompts above: opencode finds MarineCadastre AIS file list on Spiral, shows the price and runs it.

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

## MarineCadastre AIS file list tools and prices

- [MarineCadastre AIS vessel traffic daily files · Records list](https://spiral.ai/tools/alexandria/marinecadastre-gov/vessel-traffic/records_list) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page_size | 1 to 400 | — | Records per page (default 100; a year has at most 366). |
| continuation |  | — | Opaque cursor from the previous page's meta.page.next_cursor. It pins the publication; when the year was rewritten since, the call fails with invalid_input at /continuation (issue code publication_changed). |

## What can you do with MarineCadastre AIS file list in opencode?

Build a checked download manifest for a coastal traffic study. A coding agent can compare archive publications, inspect daily file metadata, and adapt the project's loader using opening-row previews.

### Prepare a seasonal port traffic study

For a Charleston Harbor study, check the available study dates, collect the year's daily file descriptors, and inspect opening rows before downloading and filtering the full files.

### Collect inputs for offshore wind planning

For a Virginia offshore planning area, establish the available archive period, build the daily download manifest, and inspect selected files before a separate geographic analysis.

### Prepare a dredging traffic baseline

For a Savannah Harbor planning study, confirm historical dates, gather daily file URLs, and inspect file details before processing vessel observations around the proposed work area.

### Rebuild a study after an archive change

Compare the archive publication with the study's saved publication, refresh the daily manifest when it changes, and inspect affected file checksums before rebuilding derived planning results.

### Audit missing study dates

Compare available dates and daily file listings with the study calendar. Flag April 23, 2015 as a documented archive gap when preparing a 2015 coastal planning baseline.

### Check files before a bulk import

Use the yearly manifest to select daily files, then inspect their metadata and opening rows before committing to a full download and parser run.

## Overview

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

## MarineCadastre AIS file list in other agents

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

## More opencode guides

- [MarineCadastre AIS archive status](https://spiral.ai/integrations/opencode/marinecadastre-ais-archive-status)
- [MarineCadastre daily AIS file](https://spiral.ai/integrations/opencode/marinecadastre-daily-ais-file)
- [Legistar public office holders](https://spiral.ai/integrations/opencode/legistar-public-office-holders)
- [Mass.gov agency details](https://spiral.ai/integrations/opencode/mass-gov-agency-details)
- [Legistar meeting calendar](https://spiral.ai/integrations/opencode/legistar-meeting-calendar)
- [Mass.gov application forms](https://spiral.ai/integrations/opencode/mass-gov-application-forms)

## Questions about MarineCadastre AIS file list in opencode

**Can opencode use MarineCadastre AIS file list?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run MarineCadastre AIS file list like any built-in tool.

**How much does MarineCadastre AIS file list cost in opencode?**

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

**Do I need an Alexandria account to use MarineCadastre AIS file list in opencode?**

No. Spiral runs MarineCadastre AIS file list on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up MarineCadastre AIS file list in opencode?**

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

**Does opencode wait while MarineCadastre AIS file list runs?**

MarineCadastre AIS file list runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Does MarineCadastre show where vessels are right now?**

No. MarineCadastre publishes historical AIS records and explicitly does not provide live vessel feeds.

**How detailed are the vessel observations?**

NOAA filters the original AIS records to a one-minute frequency. These files therefore do not preserve every broadcast received from a vessel.

**How far back does the daily CSV archive go?**

National daily CSV files begin in 2015. NOAA's earlier archive uses monthly geodatabases organized by UTM zone, so those years require a different loading approach.

**Does the 2024 archive include Alaska?**

No. NOAA's 2024 metadata says all Alaska records were removed, including observations collected by Coast Guard NAIS receivers.

**Are any entire days missing?**

Yes. NOAA explicitly identifies April 23, 2015 as missing from the archive. A study spanning that date needs to account for the gap.

