Skip to main content
Glama
jktjj

jktjj-mcp

by jktjj
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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:

{
  "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.

Related MCP server: Countries MCP Server

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers