geocode
Pack: openweather · Endpoint: https://gateway.pipeworx.io/openweather/mcp
Resolve a place name (city, optionally with state/country) to geographic coordinates (latitude/longitude). Useful before calling air_quality, which needs lat/lon. Example: geocode({ query: “Paris”, limit: 5 })
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | Place name to look up, e.g. “Paris”, “Springfield,IL,US”. |
limit | number | no | Maximum number of matching locations to return (default 5). |
Example call
Arguments
{
"query": "Paris",
"limit": 5,
"_apiKey": "your-openweather-api-key"
}
curl
curl -X POST https://gateway.pipeworx.io/openweather/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"geocode","arguments":{"query":"Paris","limit":5,"_apiKey":"your-openweather-api-key"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('geocode', {
"query": "Paris",
"limit": 5,
"_apiKey": "your-openweather-api-key"
});
More examples
{
"query": "Springfield,IL,US",
"_apiKey": "your-openweather-api-key"
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"openweather": {
"url": "https://gateway.pipeworx.io/openweather/mcp"
}
}
}
See Getting Started for client-specific install steps.