JKTJJ MCP Server

Name: JKTJJ MCP Server
Author: jktjj

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:

{
  "mcp": {
    "jktjj": {
      "type": "remote",
      "url": "https://mcp.jktjj.com/mcp",
      "enabled": true
    }
  }
}

Claude Desktop

Add to claude_desktop_config.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

npx @smithery/cli mcp add jktjj-com/jktjj-mcp

MCP Inspector

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

npm install
npm run dev

The server starts on http://localhost:8787.

Deploy

npm run deploy

Tests

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.

jktjj.com/data/*  →  /api/x402/data-snapshot  →  mcp Worker (in-memory cache)  →  MCP tools

License

MIT