JKTJJ MCP Server
BJJ gym, coach, event, and city data for AI agents. Free base tools, x402-paid premium.
Open source Repository Open in the app JSON README (API)
About
BJJ gym, coach, event, and city data for AI agents. Free base tools, x402-paid premium.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- jktjj
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.1.0
- Stars
- 1
- Last push
- 2026-07-07T02:43:31Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:00:15
- Updated
- 2026-08-29 04:00:15
- Origin id
io.github.jktjj/jktjj-mcp
README
# JKTJJ MCP Server
[](https://smithery.ai/server/jktjj-com/jktjj-mcp)
[](https://opensource.org/licenses/MIT)
MCP server for AI agent access to JKTJJ's structured BJJ data — gyms, coaches, events, and cities worldwide.
## Install
### opencode
Add to your `opencode.json`:
```json
{
"mcp": {
"jktjj": {
"type": "remote",
"url": "https://mcp.jktjj.com/mcp",
"enabled": true
}
}
}
```
### Claude Desktop
Add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"jktjj": {
"type": "url",
"url": "https://mcp.jktjj.com/mcp"
}
}
}
```
### Cursor
Settings → MCP Servers → Add:
- Name: `jktjj`
- Type: `url`
- URL: `https://mcp.jktjj.com/mcp`
### Smithery
```bash
npx @smithery/cli mcp add jktjj-com/jktjj-mcp
```
### MCP Inspector
```bash
npx @modelcontextprotocol/inspector
```
Then connect to `https://mcp.jktjj.com/mcp`.
## Remote URL
```
https://mcp.jktjj.com/mcp
```
## Tools
### Free Tools (no auth required)
| Tool | Description |
|---|---|
| `list_cities` | List supported cities, filterable by country |
| `get_city` | Full city details by slug |
| `list_gyms` | Filtered gym list (city, gi/nogi, open mat, affiliation, instructor) |
| `get_gym` | Full gym profile by city + gym slug |
| `list_events` | Filtered event list (city, date range, type) |
| `get_event` | Full event details by slug |
### Premium Tools (x402 USDC — $0.005–$0.02/call)
| Tool | Description | Price |
|---|---|---|
| `search_schedule` | Search schedules by day, time, class type across a city | $0.02 |
| `find_open_mats` | Open mat sessions by city and day | $0.005 |
| `search_jktjj` | Cross-index text search (cities, gyms, coaches, events) | $0.005 |
| `list_coaches` | Filtered coach list (city, affiliation) | $0.005 |
| `get_coach` | Full coach profile by slug | $0.005 |
| `get_schedule` | Weekly schedule for a gym or all gyms in a city | $0.005 |
| `bulk_export` | City-level data export (gyms, events, coaches) | $0.005 |
## Resources
| URI | Description |
|---|---|
| `jktjj://catalog` | API catalog with endpoints, pricing, and optimization hints |
| `jktjj://agent-guide` | Routing instructions, decision defaults, and query examples |
| `jktjj://llms.txt` | JKTJJ llms.txt content |
| `jktjj://snapshot` | Current snapshot version and counts |
## Prompts
| Prompt | Description |
|---|---|
| `plan_training_trip` | Build a training itinerary for a city and date range |
| `find_open_mat` | Find open mat sessions in a city on a specific day |
| `summarize_week_in_bjj` | Get a weekly summary of BJJ events |
## Agent Discovery
External agents and bots can discover how to use the MCP server through these public surfaces:
| Surface | URL | Format |
|---|---|---|
| Well-known skill | `https://jktjj.com/.well-known/jktjj/SKILL.md` | Markdown |
| MCP resource | `jktjj://agent-guide` | Markdown (after connecting) |
| llms.txt | `https://jktjj.com/llms.txt` | Plain text |
| Catalog (HTTP) | `https://jktjj.com/api/x402/v1/catalog` | JSON |
| For Developers | `https://jktjj.com/for-developers` | HTML |
The well-known SKILL.md contains routing instructions, decision defaults, and query examples. Agents can fetch it via HTTP GET without connecting to the MCP server.
## Registries
| Registry | Status | URL |
|---|---|---|
| MCP Registry | Pending | https://registry.modelcontextprotocol.io |
| Smithery | Published | https://smithery.ai/server/jktjj-com/jktjj-mcp |
| Cline Marketplace | Submitted | https://github.com/cline/mcp-marketplace/issues |
| MCP.Directory | Submitted | https://mcp.directory |
| MCP.so | Submitted | https://mcp.so |
## Development
### Prerequisites
- Node.js
- Cloudflare account with Workers enabled
- Domain `mcp.jktjj.com` configured in Cloudflare DNS
### Quick Start
```bash
npm install
npm run dev
```
The server starts on `http://localhost:8787`.
### Deploy
```bash
npm run deploy
```
### Tests
```bash
npm test
```
## Architecture
The MCP server fetches a data snapshot from `jktjj.com/api/x402/data-snapshot` on boot and refreshes it every 5 minutes. All tools query from this in-memory snapshot — no direct data file access at runtime.
```text
jktjj.com/data/* → /api/x402/data-snapshot → mcp Worker (in-memory cache) → MCP tools
```
## License
MIT