`traveltime_time_filter`

Pack: traveltime · Endpoint: https://gateway.pipeworx.io/traveltime/mcp

Which of these locations are reachable within N minutes from an origin by public transport (or driving/walking/cycling), and how long each takes. Filters candidate destinations by travel time. Example: traveltime_time_filter({ origin_lat: 51.5072, origin_lon: -0.1276, destinations: [{ id: “a”, lat: 51.52, lon: -0.09 }, { id: “b”, lat: 51.60, lon: -0.20 }], travel_time: 45, minutes: true, transport: “public_transport”, departure_time: “2026-07-06T08:30:00Z”, _apiKey: “appId:apiKey” })

Parameters

Name	Type	Required	Description
`origin_lat`	number	no	Origin latitude
`origin_lon`	number	no	Origin longitude
`destinations`	array	no	Candidate destinations to test. Each: { id?, lat, lon }. Max 2000. IDs auto-generated (“dest_0”, …) if omitted.
`Each`	unknown	no
`items`	object	no
`properties`	string	no
`id`	string	no
`lat`	number	yes
`lon`	number	yes
`travel_time`	number	no	Max journey time. Seconds by default (default 1800 = 30 min). Set minutes:true to pass minutes. Max 14400s / 240 min.
`minutes`	boolean	no	If true, travel_time is interpreted as minutes and multiplied by 60.
`transport`	string	no	Transport mode (default “public_transport”). One of: driving, walking, cycling, public_transport, driving+public_transport.
`departure_time`	string	no	ISO 8601 departure timestamp (e.g. “2026-07-06T08:30:00Z”). Public-transport searches need a timestamp; defaults to now if omitted.
`_apiKey`	string	no	TravelTime credentials as “appId:apiKey” from your traveltime.com account.

Example call

Arguments

{
  "origin_lat": 51.5072,
  "origin_lon": -0.1276,
  "destinations": [
    {
      "id": "cafe_a",
      "lat": 51.52,
      "lon": -0.09
    },
    {
      "id": "cafe_b",
      "lat": 51.6,
      "lon": -0.2
    }
  ],
  "travel_time": 45,
  "minutes": true,
  "transport": "public_transport",
  "departure_time": "2026-07-06T08:30:00Z",
  "_apiKey": "your-traveltime-appId:apiKey"
}

curl

curl -X POST https://gateway.pipeworx.io/traveltime/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"traveltime_time_filter","arguments":{"origin_lat":51.5072,"origin_lon":-0.1276,"destinations":[{"id":"cafe_a","lat":51.52,"lon":-0.09},{"id":"cafe_b","lat":51.6,"lon":-0.2}],"travel_time":45,"minutes":true,"transport":"public_transport","departure_time":"2026-07-06T08:30:00Z","_apiKey":"your-traveltime-appId:apiKey"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('traveltime_time_filter', {
  "origin_lat": 51.5072,
  "origin_lon": -0.1276,
  "destinations": [
    {
      "id": "cafe_a",
      "lat": 51.52,
      "lon": -0.09
    },
    {
      "id": "cafe_b",
      "lat": 51.6,
      "lon": -0.2
    }
  ],
  "travel_time": 45,
  "minutes": true,
  "transport": "public_transport",
  "departure_time": "2026-07-06T08:30:00Z",
  "_apiKey": "your-traveltime-appId:apiKey"
});

More examples

{
  "origin_lat": 40.7128,
  "origin_lon": -74.006,
  "destinations": [
    {
      "lat": 40.75,
      "lon": -73.99
    },
    {
      "lat": 40.68,
      "lon": -74.02
    }
  ],
  "travel_time": 20,
  "minutes": true,
  "transport": "walking",
  "_apiKey": "your-traveltime-appId:apiKey"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

traveltime_time_filter