BJJ Square

Find Brazilian jiu-jitsu and grappling gyms by city, by country, or near a point. Give at least one of: city, country, or lat+lng. Returns at most 25 gyms per call (no pagination: narrow the area for more specific results). Each gym has a link to its public page on bjjsquare.com, where contacts and full details are shown. Use get_gym with the slug for the class schedule and what the gym offers.

{
  "type": "object",
  "properties": {
    "city": {
      "description": "City name, in the local language or in English (e.g. \"Milano\" or \"Milan\").",
      "type": "string",
      "minLength": 2,
      "maxLength": 80
    },
    "country": {
      "description": "ISO 3166-1 alpha-2 country code, e.g. IT. Recommended with city, to avoid same-name cities.",
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "lat": {
      "description": "Latitude of the search center.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "lng": {
      "description": "Longitude of the search center.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "radius_km": {
      "description": "Search radius around lat/lng in km. Default 25, max 100.",
      "type": "number",
      "minimum": 1,
      "maximum": 100
    },
    "limit": {
      "description": "Max results. Default 10, max 25.",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "lang": {
      "description": "Language of the returned bjjsquare.com links: it, en, es, pt, fr or de. Default en.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es",
        "pt",
        "fr",
        "de"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Public details of one gym by its slug (from find_gyms): address, website, affiliation, what it offers, class schedule when the gym has published one, and when the schedule was last updated. Only known facts are returned: a missing field means unknown, not "no". Phone and email are on the gym page linked in the result.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Gym slug, e.g. as returned by find_gyms."
    },
    "lang": {
      "description": "Language of the returned bjjsquare.com links: it, en, es, pt, fr or de. Default en.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es",
        "pt",
        "fr",
        "de"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Countries covered by BJJ Square with gym counts, or, with a country code, the cities of that country with gym counts (largest 200). Use it to check coverage before find_gyms.

{
  "type": "object",
  "properties": {
    "country": {
      "description": "ISO 3166-1 alpha-2 code. Omit to list countries.",
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "lang": {
      "description": "Language of the returned bjjsquare.com links: it, en, es, pt, fr or de. Default en.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es",
        "pt",
        "fr",
        "de"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Upcoming BJJ and grappling competitions from federation and organizer calendars (IBJJF, AJP, Smoothcomp and others), by country and date range. Returns at most 10 per call with the link to the organizer for registration, plus the BJJ Square calendar page for the full list.

{
  "type": "object",
  "properties": {
    "country": {
      "description": "ISO 3166-1 alpha-2 code. Omit for worldwide.",
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "from": {
      "description": "Start date YYYY-MM-DD. Default today; past dates are moved to today.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "End date YYYY-MM-DD. Default from + 90 days, max from + 366 days.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "limit": {
      "description": "Max results. Default 5, max 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    },
    "lang": {
      "description": "Language of the returned bjjsquare.com links: it, en, es, pt, fr or de. Default en.",
      "type": "string",
      "enum": [
        "it",
        "en",
        "es",
        "pt",
        "fr",
        "de"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}