Tomtom

mcp-tomtom

TomTom MCP — TomTom Search & Routing API（api.tomtom.com）をラップします

Pipeworx の一部です — AI エージェントを1684以上のライブデータソースに接続するMCPゲートウェイです。

ツール

ツール	説明
geocode	ジオコーディング：住所、地名、または自由形式の場所の検索語を地理座標（緯度／経度）に変換します。整形済み住所、国、緯度、経度、種別、マッチスコアを返します。例：geocode({ query: "350 5th Ave, New York" })
search_poi	施設（POI）— 店舗、ランドマーク、レストラン、ガソリンスタンドなど — を名前またはカテゴリで検索します。必要に応じて、緯度／経度の中心地点から半径を指定して検索できます。名前、カテゴリ、住所、座標、電話番号、URL、距離を返します。例：search_poi({ query: "coffee", lat: 40.748, lon: -73.985, radius: 1000 })
reverse_geocode	リバースジオコーディング：緯度／経度の座標を、人が読める住所に変換します。自由形式の住所、国、自治体、通りの名前、郵便番号、位置を返します。例：reverse_geocode({ lat: 40.748, lon: -73.985 })
route	交通状況を考慮したルート案内：2地点間の最適なルートを計算し、距離とライブ交通情報に基づく所要時間を返します。交通による遅延も報告するため、交通がスムーズな場合の推定ではなく、現実的な到着予定時刻が得られます。自動車、トラック、徒歩、自転車の移動モードに対応しています。例：route({ from_lat: 40.748, from_lon: -73.985, to_lat: 40.689, to_lon: -74.044 })

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "tomtom": {
      "url": "https://gateway.pipeworx.io/tomtom/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/tomtom/mcp の tools/list は、上の表にあるツールに加えて、共通の Pipeworx メタツールである ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツール一式を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールに加えて、共通ツールが約30個表示されます。接続時の initialize 応答に正確な範囲が示されており、その日の情報を確認するうえで最も信頼できる情報源です。

これは意図的な仕様であり、偶然の多重化ではありません。パックの範囲外の質問にも、カタログ全体を横断して振り分ける ask_pipeworx を使って回答できるのが、メタツールの役割です。そのため、MCP サーバーをもう1つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、完全版ゲートウェイに一度だけ接続してください。

このパックのツールだけでなく、すべてのパックのツールを直接一覧表示するには、完全版の Pipeworx ゲートウェイに接続します：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも、同じゲートウェイと同じ1684以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。ask_pipeworx を使えば、どちらからでもすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/tomtom_geocode \
  -H 'Content-Type: application/json' \
  -d '{"query":"350 5th Ave, New York"}'

最初の呼び出しではアカウントは不要です。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/tomtom_geocode を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です：

{
  "mcpServers": {
    "tomtom": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-tomtom"]
    }
  }
}

または、直接実行して起動を確認できます：

npx -y @pipeworx/mcp-tomtom

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールですが、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。上記のパックエンドポイントでも、完全版ゲートウェイでも利用できます：

ask_pipeworx({ question: "your question about Tomtom data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細情報

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT