BJJ Square
BJJ and grappling gyms worldwide, plus upcoming competitions. Free, read-only.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"bjjsquare": {
"url": "https://bjjsquare.com/mcp"
}
}
}Remote endpoints
https://bjjsquare.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢find_gyms(city, country, lat, lng, radius_km, ...)
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.
Input Schema
{
"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 a named place to search around (a city, neighbourhood or landmark). Not the user's own position. Rounded to 2 decimals (about 1 km).",
"type": "number",
"minimum": -90,
"maximum": 90
},
"lng": {
"description": "Longitude of the same named place. Rounded to 2 decimals.",
"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"
}🟢get_gym(slug, lang)
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.
Input Schema
{
"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"
}🟢list_places(country, lang)
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.
Input Schema
{
"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"
}🟢find_competitions(country, from, to, limit, lang)
Upcoming BJJ and grappling competitions from an aggregated public calendar: BJJ Square collects the dates organizers publish on their own public listings (IBJJF, AJP, Smoothcomp, national federations and others). Search by country and date range. Returns at most 10 per call, each with the official organizer page (the source to register and to confirm details), plus the BJJ Square calendar page for the full list.
Input Schema
{
"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"
}Community
Evidence