# JKTJJ MCP Server [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/jktjj/jktjj-mcp  
**GitHub Stars:** 1  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/jktjj-mcp-server

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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "jktjj-mcp-server": {
    "command": "npx",
    "args": ["-y","@smithery/cli"]
  }
}
```

## Documentation & README

# JKTJJ MCP Server

[![Smithery](https://img.shields.io/badge/Smithery-jktjj--com%2Fjktjj--mcp-blue)](https://smithery.ai/server/jktjj-com/jktjj-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/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)

| 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

```bash
npm install
npm 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