Geography
Calculate the shortest distance between two points on Earth using the great circle formula
Call this tool from your code in three languages.
curl -X POST 'https://api.elysiatools.com/en/api/tools/great-circle-distance' \
-H 'Content-Type: application/json' \
-d '{"lat1":40.7128,"lon1":-74.006,"lat2":51.5074,"lon2":-0.1278,"unit":"km","precision":2}'Send a POST request with your inputs as JSON. File parameters require a separate upload first.
POST https://api.elysiatools.com/en/api/tools/great-circle-distance| Name | Type | Required | Description |
|---|---|---|---|
| lat1 | number | Yes | — |
| lon1 | number | Yes | — |
| lat2 | number | Yes | — |
| lon2 | number | Yes | — |
| unit | select | No | — |
| precision |
Add this tool to your Model Context Protocol server so AI agents can list and call it.
Add this block to your MCP client configuration:
{
"mcpServers": {
"elysiatools-great-circle-distance": {
"name": "great-circle-distance",
"description": "Calculate the shortest distance between two points on Earth using the great circle formula",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=great-circle-distance",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}After connecting to the SSE endpoint, list the exposed tools:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Invoke the tool by its id, passing arguments built from its parameters:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "great-circle-distance",
"arguments": {
"lat1": 40.7128,
"lon1": -74.006,
"lat2": 51.5074,
"lon2": -0.1278,
"unit": "km",
"precision": 2
}
}
}Questions or issues? Contact [email protected]
| number |
| No |
| — |
JSON result
{
"key": {...},
"metadata": {
"key": "value"
},
"error": "Error message (optional)",
"message": "Notification message (optional)"
}