English Français العربية

JKTJJ MCP Server

Official registry Maps, travel and weather

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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

Frequently asked questions

What is JKTJJ MCP Server?

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

How do I install JKTJJ MCP Server?

It runs as a remote server. In Claude Code: claude mcp add --transport http jktjj-mcp-server 'https://mcp.jktjj.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does JKTJJ MCP Server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is JKTJJ MCP Server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains JKTJJ MCP Server?

It is published by jktjj. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.