cs_search_for_geonames_id
Find GeoNames IDs for place names to filter correspondences by location. Resolves place names to standard identifiers for correspSearch queries.
Instructions
Search for GeoNames IDs by place name.
PURPOSE: Find GeoNames identifiers for places to use as filters.
WHEN TO USE:
When you need a GeoNames ID for correspSearch place filtering
To resolve place names to standard identifiers
For geographic analysis of correspondence networks
WHEN NOT TO USE:
For person or organization names → use search_for_gnd_id()
When you already have a GeoNames ID
Args: place_query: Place name to search for (e.g., "Berlin", "Paris") country: Optional ISO-2 country code to restrict search (e.g., "DE", "FR") limit: Maximum number of results to return
Returns: List of dicts with place information: - geonameId: The GeoNames ID (use this for correspSearch) - name: Place name - countryCode: ISO-2 country code - lat, lng: Coordinates - adminName1: First-level admin division (e.g., state) - population: Population count (if available)
Example: >>> results = await search_for_geonames_id("Berlin", country="DE") >>> geonames_id = str(results[0]['geonameId']) >>> letters = await search_correspondences(place_geonames=geonames_id)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"place_query": "<place_query>"
},
"name": "cs_search_for_geonames_id"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| country | No | ||
| place_query | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |