JKTJJ MCP Server

io.github.jktjjPublished by GitHub account jktjjv0.1.0Updated Nov 2, 2026

BJJ gym, coach, event, and city data for AI agents. Free base tools, x402-paid premium.

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

Remote MCP server giving assistants structured Brazilian Jiu-Jitsu data on cities, gyms, coaches and events, with some tools paid per call.

What you can do
  • Browse cities and city details, filterable by country
  • List and read gym profiles by city, with filters for gi/nogi, open mat, affiliation and instructor
  • List and read events by city, date range and type
  • Search coaches, schedules and open mat sessions, and run cross-index text search
  • Export city-level data in bulk
  • Read catalog, agent-guide and snapshot resources, and use prompts for training trips and weekly BJJ summaries
When to use it
Useful when an assistant needs to answer questions about BJJ gyms, coaches, class schedules, open mats or events in supported cities, or to plan a training trip. The free tools cover basic city, gym and event lookups; schedule, coach and search tools are billed per call.
Requirements
A remote MCP endpoint; no local runtime, account or API key is declared. The README lists the server URL for clients such as opencode, Claude Desktop, Cursor and MCP Inspector. Premium tools require x402 USDC payment.
Before you install
Most tools beyond basic city, gym and event lookups are premium and charged in USDC per call (about $0.005–$0.02), so an assistant could spend money if it calls them freely. Payment is handled through the x402 protocol, which may involve a wallet or payment credentials. Data comes from a snapshot refreshed every five minutes, so results can lag.

Installation

In SourceWeft

  1. Open JKTJJ MCP Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.jktjj%2Fjktjj-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "jktjj": {
      "type": "http",
      "url": "https://mcp.jktjj.com/mcp"
    }
  }
}

README

JKTJJ MCP Server

[Smithery] [License: 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)

ToolDescription
list_citiesList supported cities, filterable by country
get_cityFull city details by slug
list_gymsFiltered gym list (city, gi/nogi, open mat, affiliation, instructor)
get_gymFull gym profile by city + gym slug
list_eventsFiltered event list (city, date range, type)
get_eventFull event details by slug

Premium Tools (x402 USDC — $0.005–$0.02/call)

ToolDescriptionPrice
search_scheduleSearch schedules by day, time, class type across a city$0.02
find_open_matsOpen mat sessions by city and day$0.005
search_jktjjCross-index text search (cities, gyms, coaches, events)$0.005
list_coachesFiltered coach list (city, affiliation)$0.005
get_coachFull coach profile by slug$0.005
get_scheduleWeekly schedule for a gym or all gyms in a city$0.005
bulk_exportCity-level data export (gyms, events, coaches)$0.005

Resources

URIDescription
jktjj://catalogAPI catalog with endpoints, pricing, and optimization hints
jktjj://agent-guideRouting instructions, decision defaults, and query examples
jktjj://llms.txtJKTJJ llms.txt content
jktjj://snapshotCurrent snapshot version and counts

Prompts

PromptDescription
plan_training_tripBuild a training itinerary for a city and date range
find_open_matFind open mat sessions in a city on a specific day
summarize_week_in_bjjGet a weekly summary of BJJ events

Agent Discovery

External agents and bots can discover how to use the MCP server through these public surfaces:

SurfaceURLFormat
Well-known skillhttps://jktjj.com/.well-known/jktjj/SKILL.mdMarkdown
MCP resourcejktjj://agent-guideMarkdown (after connecting)
llms.txthttps://jktjj.com/llms.txtPlain text
Catalog (HTTP)https://jktjj.com/api/x402/v1/catalogJSON
For Developershttps://jktjj.com/for-developersHTML

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

RegistryStatusURL
MCP RegistryPendinghttps://registry.modelcontextprotocol.io
SmitheryPublishedhttps://smithery.ai/server/jktjj-com/jktjj-mcp
Cline MarketplaceSubmittedhttps://github.com/cline/mcp-marketplace/issues
MCP.DirectorySubmittedhttps://mcp.directory
MCP.soSubmittedhttps://mcp.so

Development

Prerequisites

  • Node.js
  • Cloudflare account with Workers enabled
  • Domain mcp.jktjj.com configured in Cloudflare DNS

Quick Start

bash
npm installnpm 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

Source: README.md at commit 4e47ece

Tools

13

list_cities

Parameterslimitcountry

get_city

ParameterscitySlugrequired

list_gyms

ParametershasGilimithasNogicitySlughasOpenMatopenMatDayaffiliationinstructorName

get_gym

ParametersgymSlugrequiredcitySlugrequired

list_coaches

ParameterslimitcitySlugaffiliation

get_coach

ParameterscoachSlugrequired

list_events

ParameterstofromtypelimitcitySlug

get_event

ParameterseventSlugrequired

search_jktjj

Parameterslimitqueryrequiredscope

find_open_mats

ParameterscitySlugrequireddayOfWeek

get_schedule

ParametersgymSlugcitySlugrequired

search_schedule

ParameterslimitcitySlugrequiredclassTypedayOfWeektimeWindow

bulk_export

ParameterscitySlugrequired

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts