Matrix Tool
matrix_toolCalculates travel times and distances between multiple points using Mapbox Matrix API.
When to Use
Use this tool when you need to calculates travel times and distances between multiple points using mapbox matrix api.. This is part of the Mapbox provider on xpay✦.
MCP Connection
Connect to xpay✦ to access this tool (and 8+ others):
{
"mcpServers": {
"xpay": {
"url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
}
}
}
For Claude Code:
claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
How to Execute
Use the xpay✦ meta-tools to run this tool:
xpay_details— Get full input schema:xpay_details("mapbox/matrix_tool")xpay_run— Execute:xpay_run("mapbox/matrix_tool", { ...inputs })
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
bearings | string | No | A semicolon-separated list of headings and allowed deviation indicating the direction of movement. Input as two comma-separated values per location: a heading course measured clockwise from true north between 0 and 360, and the range of degrees by which the angle can deviate (recommended value is 45° or 90°), formatted as {angle,degrees}. If provided, the number of bearings must equal the number of coordinates. You can skip a coordinate and show its position in the list with the ; separator. |
sources | string | No | Use the coordinates at given indices as sources. Possible values are: a semicolon-separated list of 0-based indices, or "all" (default). The option "all" allows using all coordinates as sources. |
profile | string | Yes | Routing profile for different modes of transport. Options: - driving-traffic: automotive with current traffic conditions (limited to 10 coordinates) - driving: automotive based on typical traffic - walking: pedestrian/hiking - cycling: bicycle |
destinations | string | No | Use the coordinates at given indices as destinations. Possible values are: a semicolon-separated list of 0-based indices, or "all" (default). The option "all" allows using all coordinates as destinations. |
coordinates | array | Yes | Array of coordinate objects with longitude and latitude properties. Must include at least 2 coordinate pairs. Up to 25 coordinates total are supported for most profiles (10 for driving-traffic). |
annotations | string | No | Specifies the resulting matrices. Possible values are: duration (default), distance, or both values separated by a comma. |
approaches | string | No | A semicolon-separated list indicating the side of the road from which to approach waypoints. Accepts "unrestricted" (default, route can arrive at the waypoint from either side of the road) or "curb" (route will arrive at the waypoint on the driving_side of the region). If provided, the number of approaches must be the same as the number of waypoints. You can skip a coordinate and show its position with the ; separator. |
Pricing
- Cost: $0.01/call
- Balance check: Use
xpay_balanceto check remaining credits - Get your API key at xpay.tools — $5 free credits included
Related Skills
- Mapbox (all tools) — 9 tools
- Version Tool — $0.01/call
- Category Search Tool — $0.01/call
- Directions Tool — $0.01/call
- Forward Geocode Tool — $0.01/call
- Isochrone Tool — $0.01/call
Links
- Tool page: https://xpay.tools/mapbox/matrix-tool/
- Provider: https://xpay.tools/mapbox/
- All tools: https://xpay.tools/explore
How to Execute
Input Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
bearings | string | No | A semicolon-separated list of headings and allowed deviation indicating the direction of movement. Input as two comma-separated values per location: a heading course measured clockwise from true north between 0 and 360, and the range of degrees by which the angle can deviate (recommended value is 45° or 90°), formatted as {angle,degrees}. If provided, the number of bearings must equal the number of coordinates. You can skip a coordinate and show its position in the list with the ; separator. |
sources | string | No | Use the coordinates at given indices as sources. Possible values are: a semicolon-separated list of 0-based indices, or "all" (default). The option "all" allows using all coordinates as sources. |
profile | string | Yes | Routing profile for different modes of transport. Options: - driving-traffic: automotive with current traffic conditions (limited to 10 coordinates) - driving: automotive based on typical traffic - walking: pedestrian/hiking - cycling: bicycle |
destinations | string | No | Use the coordinates at given indices as destinations. Possible values are: a semicolon-separated list of 0-based indices, or "all" (default). The option "all" allows using all coordinates as destinations. |
coordinates | array | Yes | Array of coordinate objects with longitude and latitude properties. Must include at least 2 coordinate pairs. Up to 25 coordinates total are supported for most profiles (10 for driving-traffic). |
annotations | string | No | Specifies the resulting matrices. Possible values are: duration (default), distance, or both values separated by a comma. |
approaches | string | No | A semicolon-separated list indicating the side of the road from which to approach waypoints. Accepts "unrestricted" (default, route can arrive at the waypoint from either side of the road) or "curb" (route will arrive at the waypoint on the driving_side of the region). If provided, the number of approaches must be the same as the number of waypoints. You can skip a coordinate and show its position with the ; separator. |
Install Skill
Pricing
Cost
$0.01/call
Model
Flat rate
Provider
Mapbox