JKTJJ MCP Server

io.github.jktjj由 GitHub 帳號 jktjj 發布v0.1.0更新於 Nov 2, 2026

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

已驗證Streamable HTTP可網頁執行位置與生活商業與電商

概覽

AI 產生的概覽

遠端 MCP 伺服器，為助理提供城市、道館、教練與賽事等巴西柔術結構化資料，部分工具按次付費。

可以做什麼
  • 依國家瀏覽城市清單並查看城市詳細資料
  • 依城市列出與查看道館資料，可依 gi/nogi、開放墊、所屬組織、教練篩選
  • 依城市、日期範圍與類型列出與查看賽事詳情
  • 搜尋教練、課表與開放墊場次，並進行跨索引文字搜尋
  • 依城市批次匯出資料
  • 讀取目錄、agent-guide 與快照資源，並使用訓練行程規劃等提示範本
適用情境
適合助理回答關於支援城市中柔術道館、教練、課表、開放墊或賽事的問題，或規劃訓練行程。免費工具涵蓋基本的城市、道館與賽事查詢；課表、教練與搜尋類工具按次計費。
執行需求
需要遠端 MCP 端點；未宣告本機執行環境、帳號或 API 金鑰。README 提供 opencode、Claude Desktop、Cursor 與 MCP Inspector 等用戶端的伺服器位址。進階工具需透過 x402 以 USDC 付費。
安裝前請注意
除基本的城市、道館與賽事查詢外，多數工具為進階工具，按次以 USDC 收費（約每次 0.005–0.02 美元），助理若隨意呼叫可能產生費用。付費透過 x402 協定完成，可能涉及錢包或付款憑證。資料來自每五分鐘更新的快照，結果可能有延遲。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 JKTJJ MCP Server，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.jktjj%2Fjktjj-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

來源：README.md，提交 4e47ece

工具

13

list_cities

輸入參數limitcountry

get_city

輸入參數citySlug必填

list_gyms

輸入參數hasGilimithasNogicitySlughasOpenMatopenMatDayaffiliationinstructorName

get_gym

輸入參數gymSlug必填citySlug必填

list_coaches

輸入參數limitcitySlugaffiliation

get_coach

輸入參數coachSlug必填

list_events

輸入參數tofromtypelimitcitySlug

get_event

輸入參數eventSlug必填

search_jktjj

輸入參數limitquery必填scope

find_open_mats

輸入參數citySlug必填dayOfWeek

get_schedule

輸入參數gymSlugcitySlug必填

search_schedule

輸入參數limitcitySlug必填classTypedayOfWeektimeWindow

bulk_export

輸入參數citySlug必填

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分