{"openapi":"3.1.0","info":{"title":"Bola (Ball) API","version":"0.1.0","description":"A fully local Brazilian football history and facts reference: Brazil's FIFA World Cup and Copa América record, legendary player profiles, major club honors, stadium facts, rules explainers, a glossary and a trivia quiz.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://bola.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/bola/docs"},"termsOfService":"https://connectorbay.com/bola/terms"},"servers":[{"url":"https://bola.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/bola/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/world_cup_history":{"post":{"operationId":"world_cup_history","summary":"Brazil's FIFA World Cup record: total appearances and titles, plus detailed results for every edition","description":"Brazil's FIFA World Cup record: total appearances and titles, plus detailed results for every edition\n    Brazil won or reached a notable stage in (runner-up, semifinal, or a notable knockout exit). Use for \"how did\n    Brazil do at the 2014 World Cup\", \"what's Brazil's World Cup record\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"edition":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"A specific World Cup year, e.g. 2002; omit for the full summary and edition list.","examples":[1958,1970,2002],"title":"Edition"}},"title":"world_cup_historyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/world_cup_titles_list":{"post":{"operationId":"world_cup_titles_list","summary":"All of Brazil's FIFA World Cup title years, with a one-line note on each final. Use for \"which years did","description":"All of Brazil's FIFA World Cup title years, with a one-line note on each final. Use for \"which years did\n    Brazil win the World Cup\", \"list Brazil's World Cup titles\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"world_cup_titles_listArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/legendary_players":{"post":{"operationId":"legendary_players","summary":"Factual, encyclopedia-style profiles of historically significant Brazilian players — era, position, clubs,","description":"Factual, encyclopedia-style profiles of historically significant Brazilian players — era, position, clubs,\n    World Cups won, and key facts/honors. Use for \"tell me about Pelé\", \"who was Garrincha\", \"list legendary\n    Brazilian players\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A player's name, e.g. 'Pelé' or 'Garrincha'; omit to list all.","title":"Name"}},"title":"legendary_playersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/club_info":{"post":{"operationId":"club_info","summary":"A major Brazilian club's profile: founding year, home city/state, and honors counts (Brasileirão, Copa","description":"A major Brazilian club's profile: founding year, home city/state, and honors counts (Brasileirão, Copa\n    Libertadores, Copa do Brasil titles). Use for \"tell me about Flamengo\", \"how many titles has Palmeiras won\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Club name or city.","examples":["Flamengo","Corinthians","Belo Horizonte"],"title":"Name","type":"string"}},"required":["name"],"title":"club_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/copa_america_history":{"post":{"operationId":"copa_america_history","summary":"Brazil's Copa América record: total titles, every title year, and the most recent title. Use for \"how many","description":"Brazil's Copa América record: total titles, every title year, and the most recent title. Use for \"how many\n    Copa Américas has Brazil won\", \"when did Brazil last win the Copa América\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"copa_america_historyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/rules_explainer":{"post":{"operationId":"rules_explainer","summary":"Plain-language explanations of generic football/soccer rules — offside, VAR, yellow/red cards, penalty","description":"Plain-language explanations of generic football/soccer rules — offside, VAR, yellow/red cards, penalty\n    kicks, extra time and penalty shootouts — based on the standard IFAB Laws of the Game, not Brazil-specific.\n    Use for \"what's offside\", \"explain VAR\", \"how does a penalty shootout work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A rule, e.g. offside, var, yellow_red_cards, penalty_kicks, extra_time_penalty_shootout. Omit to list all.","title":"Topic"}},"title":"rules_explainerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/stadium_info":{"post":{"operationId":"stadium_info","summary":"A major Brazilian stadium's seating capacity, city, and a notable history fact. Use for \"how big is the","description":"A major Brazilian stadium's seating capacity, city, and a notable history fact. Use for \"how big is the\n    Maracanã\", \"which stadium is in Porto Alegre\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Stadium name or city.","examples":["Maracanã","Mineirão","Belo Horizonte"],"title":"Name","type":"string"}},"required":["name"],"title":"stadium_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/football_glossary":{"post":{"operationId":"football_glossary","summary":"Definitions of Brazilian football terms and slang (craque, camisa 10, drible, gol de placa, ginga, ...).","description":"Definitions of Brazilian football terms and slang (craque, camisa 10, drible, gol de placa, ginga, ...).\n    Use for \"what does craque mean\", \"what's a gol de placa\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"football_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/trivia_quiz":{"post":{"operationId":"trivia_quiz","summary":"A fresh multiple-choice Brazilian football trivia question, generated from this connector's own verified","description":"A fresh multiple-choice Brazilian football trivia question, generated from this connector's own verified\n    data (never a separate, harder-to-verify question bank). Use for \"quiz me on Brazilian football\", \"give me a\n    World Cup trivia question\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"world_cup | player | club | stadium | copa_america; omit for a random category.","title":"Category"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Optional seed for a reproducible question.","title":"Seed"}},"title":"trivia_quizArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}