# Hermes Mcp Tomtom

> TomTom Maps MCP integration for Hermes-Agent — search, routing, traffic, maps, and EV via hosted MCP endpoint

- **Type:** MCP server
- **Install:** `agentstack add mcp-drknght4-hermes-mcp-tomtom`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Drknght4](https://agentstack.voostack.com/s/drknght4)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Drknght4](https://github.com/Drknght4)
- **Source:** https://github.com/Drknght4/hermes-mcp-tomtom

## Install

```sh
agentstack add mcp-drknght4-hermes-mcp-tomtom
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# hermes-mcp-tomtom

TomTom Maps MCP server integration for [Hermes-Agent](https://github.com/NousResearch/hermes-agent). Wire TomTom's search, routing, traffic, and mapping capabilities into your Hermes instance via the Model Context Protocol — no local server to run, just configure and go.

## What This Gives You

16 MCP tools registered as first-class Hermes tools — geocoding, fuzzy search, POI discovery, routing, EV routing, traffic incidents, interactive maps, and more. All powered by TomTom's hosted MCP endpoint at `https://mcp.tomtom.com/maps`.

| Tool | Description |
|------|-------------|
| `tomtom-geocode` | Address → coordinates (+ interactive map) |
| `tomtom-reverse-geocode` | Coordinates → address (+ interactive map) |
| `tomtom-fuzzy-search` | Typo-tolerant search for addresses, POIs, geographies |
| `tomtom-poi-search` | Search by business name or browse POI categories |
| `tomtom-nearby` | Find places close to a specific point |
| `tomtom-poi-categories` | Look up POI category codes from natural language |
| `tomtom-area-search` | Find all POIs within a geographic boundary (polygon/bbox/circle) |
| `tomtom-ev-search` | Find EV charging stations with real-time availability |
| `tomtom-search-along-route` | Find POIs along a route (gas, restaurants, hotels) |
| `tomtom-routing` | Calculate optimal routes through ordered locations |
| `tomtom-reachable-range` | Area reachable within specified time or distance |
| `tomtom-ev-routing` | EV routes with automatic charging stop optimization |
| `tomtom-traffic` | Traffic incidents in an area on an interactive map |
| `tomtom-dynamic-map` | Custom map images with markers, lines, polygons, overlays |
| `tomtom-data-viz` | Custom GeoJSON data on a TomTom basemap |
| `tomtom-get-api-key` | Internal — retrieve the configured API key |

## Setup

### 1. Get a TomTom API Key

Sign up at [developer.tomtom.com](https://developer.tomtom.com/) and create an API key with these products enabled:

- Search API
- Routing API
- Traffic API
- Map Display API
- MCP Server access

### 2. Add API Key

```bash
echo 'TOMTOM_API_KEY=your_key_here' >> ~/.hermes/.env
```

### 3. Configure Hermes

Add the MCP server block to `~/.hermes/config.yaml` (see [`config-snippet.yaml`](./config-snippet.yaml)):

```yaml
mcp_servers:
  tomtom:
    url: https://mcp.tomtom.com/maps
    headers:
      tomtom-api-key: ${TOMTOM_API_KEY}
    timeout: 120
    connect_timeout: 60
```

### 4. Restart the Gateway

```bash
hermes gateway restart
```

### 5. Verify

```bash
hermes mcp list
# Should show: tomtom  https://mcp.tomtom.com/maps  all  ✓ enabled
```

All 16 tools register with the `mcp_tomtom_tomtom_` prefix (e.g., `mcp_tomtom_tomtom_routing`).

## Orbis Maps (Optional)

To use TomTom's next-gen Orbis Maps platform, add the `tomtom-maps-backend` header:

```yaml
mcp_servers:
  tomtom:
    url: https://mcp.tomtom.com/maps
    headers:
      tomtom-api-key: ${TOMTOM_API_KEY}
      tomtom-maps-backend: tomtom-orbis-maps
    timeout: 120
    connect_timeout: 60
```

Defaults to classic TomTom Maps when the header is omitted.

## Common Tool Parameters

All search/geocoding tools accept:

- `show_ui` (boolean) — interactive map widget visualization
- `response_detail` (`"compact"` default, `"full"` for complete data)
- `language` — IETF tag (e.g., `"en-US"`, `"fr-FR"`)
- `countries` — array of ISO alpha-2 codes (e.g., `["US"]`)
- `limit` — max results 1–100, default 5

## Coordinate Convention

All tools use **[longitude, latitude]** (GeoJSON convention). This applies to `locations` in routing, `position` in reverse geocode, `origin`/`destination` in search-along-route, and marker coordinates in dynamic maps.

## Pitfalls

- **API key exposure**: The `tomtom-get-api-key` tool returns the key to any caller. Restrict in untrusted contexts.
- **Free tier**: Standard plan covers Search, Routing, Traffic, and Maps. Advanced APIs require paid access.
- **Rate limits**: 5 QPS for Search, 1 QPS for Routing on standard tier.
- **`${TOMTOM_API_KEY}` interpolation**: The Hermes MCP loader resolves `${VAR_NAME}` from `~/.hermes/.env` at connection time. Never hardcode keys in `config.yaml`.

## Skill Reference

See [`SKILL.md`](./SKILL.md) for the full tool reference with parameters and usage examples.

## License

MIT

---

Built by NoVa AI — Your Data. Your Rules. Your AI.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Drknght4](https://github.com/Drknght4)
- **Source:** [Drknght4/hermes-mcp-tomtom](https://github.com/Drknght4/hermes-mcp-tomtom)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-drknght4-hermes-mcp-tomtom
- Seller: https://agentstack.voostack.com/s/drknght4
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.