`directions`

Pack: openrouteservice · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/directions for the schema, then POST the same URL with its arguments for the data.

“Directions from A to B” / “how far is [X] from [Y]” / “hiking / cycling / wheelchair / walking route” / “truck routing” / “HGV directions” / “driving route” — turn-by-turn routing between coordinates with profile-specific routing. Profiles: driving-car, driving-hgv (trucks), foot-walking, foot-hiking, cycling-regular / mountain / road / electric, wheelchair. Returns geometry, distance, duration, turn-by-turn instructions, elevation. Uses OpenStreetMap data via OpenRouteService. Use for hiking/biking/wheelchair/truck cases where Mapbox/Google don’t have the right profile.

Parameters

Name	Type	Required	Description
`coordinates`	array	yes	[[lon, lat], …]
`items`	array	no
`items`	number	no
`profile`	string	no
`format`	string	no	json (default) \| geojson \| gpx
`instructions`	boolean	no

Example call

Arguments

{
  "coordinates": [
    [
      8.681495,
      49.41461
    ],
    [
      8.687872,
      49.420318
    ]
  ],
  "profile": "driving-car",
  "instructions": true
}

curl

curl -X POST https://gateway.pipeworx.io/openrouteservice/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"directions","arguments":{"coordinates":[[8.681495,49.41461],[8.687872,49.420318]],"profile":"driving-car","instructions":true}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('directions', {
  "coordinates": [
    [
      8.681495,
      49.41461
    ],
    [
      8.687872,
      49.420318
    ]
  ],
  "profile": "driving-car",
  "instructions": true
});

More examples

{
  "coordinates": [
    [
      2.352222,
      48.856613
    ],
    [
      2.349902,
      48.853393
    ]
  ],
  "format": "geojson"
}

Response shape

Full JSON Schema

{
  "type": "object",
  "description": "Routing response from OpenRouteService"
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the openrouteservice pack

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

See Getting Started for client-specific install steps.

directions