[Integrations](https://spiral.ai/integrations) › [Hermes](https://spiral.ai/integrations/hermes) › [Marketstack stock exchange directory](https://spiral.ai/integrations/hermes/marketstack-stock-exchange-directory)

# How to Use Marketstack stock exchange directory in Hermes

Returns exchange names, MIC codes, locations, and websites from Marketstack’s directory. Use it to identify trading venues or build an exchange lookup; a directory entry does not guarantee price coverage.

|  |  |
| --- | --- |
| Model | Marketstack stock exchange directory |
| Available through | Alexandria |
| Category | Finance |
| Price | Up to $0.034918 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Marketstack stock exchange directory in Hermes

- Every Monday, use Marketstack stock exchange directory to retrieve Nasdaq matches and report any changes in names, MIC codes, locations, or websites since the previous check.
- Once a month, use Marketstack stock exchange directory to collect all pages and report added or removed records located in Japan.
- Each Friday, use Marketstack stock exchange directory to look up London Stock Exchange and summarize changes to the returned names and websites.
- Every Monday, use Marketstack stock exchange directory to retrieve XNAS and XNYS and flag changes to their returned names or locations.
- Once a month, use Marketstack stock exchange directory to retrieve Deutsche Boerse matches and compare their MIC codes and websites with the previous results.

## How to set up Marketstack stock exchange directory 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 Marketstack stock exchange 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": "marketstack/exchanges/list",
    "input": {
      "limit": 1
    }
  }'
```

Then paste one of the prompts above: Hermes finds Marketstack stock exchange directory on Spiral, shows the price and runs it.

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

## Marketstack stock exchange directory tools and prices

- [Marketstack · Exchanges](https://spiral.ai/tools/alexandria/marketstack/exchanges/list) (Alexandria): Up to $0.034918 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 100 | — | Rows per page, from 1 to 100. Default 100. The request costs the same whatever the row count. |
| offset | 0 to 1000000 | — | Rows to skip for the next page. Default 0. |
| search |  | — | Exchange name, acronym, or MIC fragment, such as nasdaq. |

## What can you do with Marketstack stock exchange directory in Hermes?

Produce a weekly report of changes in Marketstack’s exchange directory. A scheduled agent can compare saved results and flag changes to venue names, MIC codes, locations, and websites.

### Build an exchange picker

Populate a searchable trading venue selector with exchange names, MIC codes, and locations.

### Check exchange labels in imported data

Compare exchange names in a portfolio import with directory records and flag ambiguous matches for review.

### Create a regional venue reference

Collect the directory and organize returned exchanges by country and city for a market research brief.

### Enrich market reports

Expand exchange codes in a report into readable venue names and add the returned exchange websites.

### Review directory changes

Compare successive directory snapshots to identify added records and changes to names, locations, or websites.

### Prepare price coverage checks

Resolve a requested trading venue to candidate MIC codes before separately checking whether its securities have price data.

## Overview

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

## Marketstack stock exchange directory in other agents

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

## More Hermes guides

- [Marketstack dividend history](https://spiral.ai/integrations/hermes/marketstack-dividend-history)
- [Marketstack stock split history](https://spiral.ai/integrations/hermes/marketstack-stock-split-history)
- [Marketstack daily stock prices](https://spiral.ai/integrations/hermes/marketstack-daily-stock-prices)
- [Marketstack ticker search](https://spiral.ai/integrations/hermes/marketstack-ticker-search)
- [Marketstack company profile](https://spiral.ai/integrations/hermes/marketstack-company-profile)
- [NFA BASIC CFTC reparations cases](https://spiral.ai/integrations/hermes/nfa-basic-cftc-reparations-cases)

## Questions about Marketstack stock exchange directory in Hermes

**Can Hermes use Marketstack stock exchange directory?**

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run Marketstack stock exchange directory like any built-in tool.

**How much does Marketstack stock exchange directory cost in Hermes?**

Up to $0.034918 per run. 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 Marketstack stock exchange directory in Hermes?**

No. Spiral runs Marketstack stock exchange 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 Marketstack stock exchange directory in Hermes?**

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

**Does Hermes wait while Marketstack stock exchange directory runs?**

Marketstack stock exchange directory runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.

**How many exchanges does Marketstack’s directory cover?**

Marketstack documents more than 2,700 exchange records in its database. That is the directory’s scope, not a count of exchanges with available price data.

**What information identifies each exchange?**

Records include the exchange name, MIC code, country, city, and website. Marketstack also documents regulatory metadata for exchange records.

**How can I tell whether I retrieved the complete directory?**

Marketstack returns a total result count in its pagination metadata. Compare the records collected across pages with that total before treating the retrieval as complete.

**Does Marketstack guarantee that every exchange record is accurate?**

APILayer’s master agreement expressly disclaims warranties and liability for inaccuracies, errors, and omissions in licensed data. The directory therefore does not carry an unconditional accuracy guarantee.

**Does access give me unrestricted rights to republish the directory?**

APILayer’s master agreement grants only rights expressly provided in the agreement. Access alone should not be read as an unrestricted republication license.

