English Français العربية

JKTJJ MCP Server

Registre officiel Cartes, voyage et météo

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http jktjj-mcp-server 'https://mcp.jktjj.com/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "jktjj-mcp-server": {
            "type": "http",
            "url": "https://mcp.jktjj.com/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. JKTJJ MCP Server
  2. Install
  3. Remote URL
  4. Tools
  5. Resources
  6. Prompts
  7. Agent Discovery
  8. Registries
  9. Development
  10. Architecture
  11. License

JKTJJ MCP Server

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)
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
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

Questions fréquentes

Qu'est-ce que JKTJJ MCP Server ?

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

Comment installer JKTJJ MCP Server ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http jktjj-mcp-server 'https://mcp.jktjj.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour JKTJJ MCP Server ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

JKTJJ MCP Server est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient JKTJJ MCP Server ?

Il est publié par jktjj. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.