Title89/100
List sports in a city
The title clearly communicates the tool’s action and subject. Keep it concise.
Description96/100
Use this when you need the sports bookable in a Catch Corner city as data, or the sportId for a sport the user named (synonyms like "futsal", "hoops", "ice time" are matched). Not for letting the user choose a sport (use browse_sports). Data only, no UI. Rarely needed first: every other tool accepts sportName directly. Pass cityName as the user said it (or areaId from a previous result). outcome: "ok" (matchedSport set when sportName fits one sport), "sport_ambiguous", "sport_not_offered", "empty" (no_sports_in_city), or a city_* outcome. Outcomes: city_*, sport_* and facility_* mean something is missing or unclear: ask the user in one short question (never choose for them), then make the matching suggestedNext call, or call again with their answer. "empty" is a real answer: offer what suggestedNext lists; never invent times, venues or prices. service_unavailable is an outage, not "nothing available".
The description explains the capability, when to use it, and what to expect.
Inputs70/100
Explain the meaning of this value, not just its name.
cityName
City or neighborhood as the user said it, e.g. "Toronto", "Chicago, Illinois", "Hamilton". The server strips the state and matches area names and the neighborhoods they cover. A neighborhood resolves to its area (Hamilton is covered by the Toronto area). Use the returned area even when its name differs. When several areas match, ask the user which one.
Clear enough to supply this argument.
sportName
Optional sport to match, as the user said it.
Explain the meaning of this value, not just its name.
areaId
Catch Corner city id, from a previous result's context or resolve_city. Omit when passing cityName.
Clear enough to supply this argument.
latitude
User latitude for "near me" requests. Pass with longitude.
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
longitude
User longitude for "near me" requests. Pass with latitude.
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
Annotations100/100
All four behavior hints are declared.
{
"title": "List sports in a city",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Output schema53/100
Describe the returned fields so an agent can interpret the result.
View output schema
{
"type": "object",
"properties": {
"error": {
"type": [
"object",
"null"
],
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
}
}
},
"result": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"displayName": {
"type": "string"
}
}
}
},
"context": {
"type": [
"object",
"null"
],
"properties": {
"date": {
"type": [
"string",
"null"
]
},
"today": {
"type": [
"string",
"null"
]
},
"areaId": {
"type": [
"integer",
"null"
]
},
"arenaId": {
"type": [
"integer",
"null"
]
},
"sportId": {
"type": [
"integer",
"null"
]
},
"areaName": {
"type": [
"string",
"null"
]
},
"arenaName": {
"type": [
"string",
"null"
]
},
"sportName": {
"type": [
"string",
"null"
]
},
"coveredPlace": {
"type": [
"string",
"null"
]
}
}
},
"outcome": {
"type": "string"
},
"toolName": {
"type": [
"string",
"null"
]
},
"emptyReason": {
"type": [
"string",
"null"
]
},
"matchedSport": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"displayName": {
"type": "string"
}
}
},
"sportOptions": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"sportId",
"name"
],
"properties": {
"name": {
"type": "string"
},
"sportId": {
"type": "integer"
}
}
}
},
"suggestedNext": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"tool",
"arguments",
"reason"
],
"properties": {
"tool": {
"type": "string"
},
"reason": {
"type": "string"
},
"arguments": {
"type": "object"
}
}
}
},
"facilityOptions": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"required": [
"arenaId",
"name"
],
"properties": {
"name": {
"type": "string"
},
"arenaId": {
"type": "integer"
}
}
}
}
}
}