Jktjj MCP Server

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)

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

Resources

Prompts

Agent Discovery

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

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

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