BoxTier Basketball Receipt

io.github.boyakh-jpgPublished by GitHub account boyakh-jpgv1.0.0Updated Nov 2, 2026

Create a BoxTier-style PNG receipt from user-provided basketball game results.

VerifiedStreamable HTTPWeb executableLocation & LifestyleMedia & Design

Overview

AI-generated overview

BoxTier lets an assistant search public Korean basketball pickup match rooms, view a user's match records, and generate a BoxTier-style PNG game receipt.

What you can do
  • Search currently open public basketball match rooms and filter them by region, date, time or 3v3/5v5 format
  • Fetch the current details of one public match room ID before recommending it or sharing a join link
  • Check BoxTier login status, the connected account and the receipt generation quota
  • List the signed-in user's recent basketball match records
  • Create a BoxTier-style basketball game receipt as a PNG, returned inline as Base64 plus a short-lived download link
When to use it
Useful when someone wants to find a pickup basketball game or team-vs-team match in Korea, check their own BoxTier match history, or turn a finished game's result into a shareable BoxTier-style receipt image.
Requirements
A remote streamable HTTP endpoint at boxtier.kr; no package install, environment variables or headers are declared. Some tools act on a signed-in BoxTier account, so login or account linking is needed for records and receipts.
Before you install
The receipt tool produces an image from user-provided game results and returns it inline plus via a short-lived download link; the server states it passes the API's PNG through unchanged. Account tools expose the connected user's match records and quota, so only connect an account you intend to use. Search and fetch are limited to public, currently open rooms.

Installation

In SourceWeft

  1. Open BoxTier Basketball Receipt in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.boyakh-jpg%2Fboxtier/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "boxtier-basketball-receipt": {
      "type": "http",
      "url": "https://boxtier.kr/mcp"
    }
  }
}

README

RankBall

친구끼리 하는 농구 경기를 오늘의 판으로 등록하고, 경기 후 양팀 승인으로 전적과 티어를 남기는 React + Vite MVP입니다.

실행

bash
npm installnpm run dev

.env가 없어도 localStorage demo mode로 실행됩니다.

Supabase

Vite에서도 Vercel/Next 스타일의 NEXT_PUBLIC_* 환경변수를 읽도록 설정했습니다.

txt
NEXT_PUBLIC_SUPABASE_URL=...NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=...

Supabase 영속 저장은 supabase/migrations를 순서대로 적용합니다. Supabase 환경이 설정된 뒤 원격 로드가 실패하면 localStorage demo state로 후퇴하지 않고 원격 shell/error 상태를 유지합니다.

Supabase CLI migration

Production DB migration은 가능하면 Supabase CLI로 적용합니다.

powershell
supabase --version$env:SUPABASE_ACCESS_TOKEN="..."$env:SUPABASE_DB_PASSWORD="..."supabase link --project-ref olzxextphxpniwiiwwda --password $env:SUPABASE_DB_PASSWORDsupabase db push --linked --dry-runsupabase db push --linked

DATABASE_URL이 있으면 link 없이도 적용할 수 있습니다.

powershell
supabase db push --db-url "$env:DATABASE_URL" --dry-runsupabase db push --db-url "$env:DATABASE_URL"

Production 적용 뒤 schema health를 확인합니다.

powershell
Invoke-RestMethod -Method Post -Uri "https://boxtier.kr/api/system/schema-health" -Headers @{ Authorization = "Bearer $env:CRON_SECRET" }

배포 전 검증은 한 명령으로 실행합니다.

powershell
npm run verify:release -- --confirm-production=olzxextphxpniwiiwwda

verify:release는 production build 후 원격 Supabase/Auth 기반 전체 backend simulation과 schema health를 실행합니다. production ref와 정확히 같은 --confirm-production=<project-ref> CLI flag가 없으면 API/Auth 호출 전에 중단합니다. SUPABASE_SERVICE_ROLE_KEY, 테스트 Auth 환경변수, CRON_SECRET이 필요합니다. 종료 코드가 0이 아니면 배포하지 않습니다.

simulation은 실행 전에 environment, 직접 Supabase project ref, 원격 API host/ref를 stderr에 표시합니다. process당 전체 flow 반복 상한은 1회이고 자동 재시도는 cleanup 실패 시 최대 1회입니다. 별도 process를 다시 실행하는 외부 runner도 호출 횟수를 1회로 제한해야 합니다. --safety-check-only는 target guard만 검증하고 DB/API를 호출하지 않습니다.

테스트 전용 Supabase는 test URL, publishable key, service-role key를 함께 설정합니다. 원격 test API를 쓰면 실제 배포 대상과 같은 ref를 --remote-project-ref=<test-ref>로 추가합니다. 직접 ref와 원격 ref가 다르면 실행하지 않습니다.

원격 DB에는 supabase db reset --linked, DROP TABLE, TRUNCATE, 대량 DELETE를 쓰지 않습니다.

환경변수

이름위치용도
VITE_SUPABASE_URL / NEXT_PUBLIC_SUPABASE_URL브라우저/서버Supabase project URL
VITE_SUPABASE_PUBLISHABLE_KEY / NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY / VITE_SUPABASE_ANON_KEY브라우저Supabase anon/publishable key
SUPABASE_SERVICE_ROLE_KEY서버/스크립트 전용server action, seed, simulation
VITE_ENABLE_SERVER_ACTIONS브라우저server action 활성화
VITE_DEMO_LOGIN브라우저localhost 테스트 로그인 UI 허용
RANKBALL_SEED_REAL_TEST_AUTH / RANKBALL_SEED_AUTH_ONLY스크립트테스트 계정을 Supabase Auth user로 만들고 기존 profile에 연결
RANKBALL_TEST_PASSWORD / VITE_TEST_AUTH_PASSWORD스크립트/브라우저테스트 계정 password Auth용 비밀번호
RANKBALL_TEST_AUTH_EMAIL_DOMAIN / VITE_TEST_AUTH_EMAIL_DOMAIN스크립트/브라우저테스트 계정 email domain. 기본값 rankball.test
VITE_ASSET_BASE_URL / VITE_PUBLIC_ASSET_BASE_URL브라우저원격 asset base URL
VITE_NAVER_MAP_CLIENT_ID / VITE_NAVER_MAP_NCP_KEY_ID브라우저/서버 fallbackNaver map/geocode client id
NAVER_MAP_CLIENT_SECRET / NAVER_MAP_NCP_KEY / NAVER_MAP_NCP_CLIENT_SECRET서버 전용Naver geocode fallback secret
DISCORD_CLIENT_ID / DISCORD_CLIENT_SECRET / DISCORD_REDIRECT_URI서버 전용Discord OAuth
DISCORD_BOT_TOKEN / DISCORD_GUILD_ID / DISCORD_GUILD_IDS서버 전용Discord DM worker
DISCORD_PUBLIC_KEY서버 전용Discord interaction signature 검증
DISCORD_CHAT_BRIDGE_SECRET / DISCORD_CHAT_BRIDGE_URLbridge workerDiscord 방 채팅을 웹 API로 전달
DISCORD_CHAT_BRIDGE_REQUEST_TIMEOUT_MS / DISCORD_CHAT_BRIDGE_MAX_DELIVERY_ATTEMPTSbridge worker전달 timeout과 재시도 횟수. 기본 10000, 4
CRON_SECRET서버/스크립트 전용worker, maintenance, schema-health
SUPABASE_ACCESS_TOKENCLI 전용Supabase Management API 인증
SUPABASE_DB_PASSWORDCLI 전용supabase link, supabase db push --linked 원격 DB 비밀번호
SUPABASE_PROJECT_IDCLI/CI 전용Supabase project ref. 현재 production ref: olzxextphxpniwiiwwda
DATABASE_URLCLI/서버 전용supabase db push --db-url 또는 직접 Postgres 접속
RANKBALL_SIM_BASE_URL / RANKBALL_SIM_SECRET / RANKBALL_SIM_TIMEOUT_MS / RANKBALL_SIM_CLEANUP_TIMEOUT_MS스크립트backend simulation
RANKBALL_SIM_REMOTE_PROJECT_REF스크립트원격 test API가 사용하는 Supabase project ref. --remote-project-ref가 우선
RANKBALL_SIM_REPEAT / RANKBALL_SIM_MAX_RETRIES스크립트전체 flow 반복 상한 1, cleanup 재시도 상한 1

Discord 방 채팅 bridge

상시 실행 환경에서 아래 명령을 실행합니다. Gateway worker는 heartbeat ACK 누락 시 재연결하고, 가능한 세션은 resume하며, 웹 API의 timeout·429·5xx를 제한 횟수만큼 재시도합니다.

powershell
npm run discord:room-chat-bridge

운영에서는 DISCORD_CHAT_BRIDGE_SECRET을 별도로 설정합니다. CRON_SECRET fallback은 기존 배포 호환용입니다.

Vercel

Framework preset은 Vite, build command는 npm run build, output directory는 dist입니다.

Source: README.md at commit fa8835b

Tools

5

fetch

BoxTier 공개 농구 매칭방 상세 조회

search가 반환한 BoxTier 공개 농구 매칭방 ID 하나의 현재 상세 조건을 조회한다. 검색 결과를 추천하거나 참가 링크를 안내하기 전에 사용한다. 임의의 비공개 방이나 종료된 방 조회에는 사용하지 않는다.

Parametersidrequired

get_my_boxtier_account

BoxTier 로그인 연결 확인

BoxTier 로그인을 시작하거나 현재 연결된 내 계정과 영수증 생성 한도 정책을 확인한다. 사용자가 로그인, 계정 연결, 내 기록 이용 가능 여부 또는 영수증 한도를 물으면 사용한다.

Takes no parameters.

list_my_match_records

내 BoxTier 경기 기록 조회

로그인한 BoxTier 사용자의 최근 농구 경기 기록을 조회한다. 사용자가 내 경기, 내 기록, 이전 경기 또는 기록으로 영수증 만들기를 요청할 때 사용한다.

Parameterslimitoffset

create_basketball_receipt

BoxTier 농구 영수증 PNG 만들기

박스티어(BoxTier) 스타일의 농구 경기 영수증 PNG를 만든다. 이 출력에는 BoxTier API만 사용한다. 성공 시 완성된 최종 PNG 한 장은 tool result의 content[0]에 type=image, mimeType=image/png, raw Base64 data로 직접 첨부되고, structuredContent.downloadUrl에는 동일 PNG 원본을 내려받는 단기 만료 링크가 제공된다. API가 반환한 PNG 원본만 사용자에게 그대로 전달하고 재합성·재렌더·임의 편집하지 않는다. 별도 위젯을 열지 않고 처리 중·완료 문구를 별도로 반복하지 않는다. 반환된 image content 또는 downloadUrl을 영수증 결과로 사용자에게 직접 제시하고 metadata만으로 완료 처리하지 않는다. structuredContent는 첨부 여부·바이트 길이·실제 크기·SHA-256 검증값을 제공한다. 네이티브 대화 이미지 첨부 여부와 기본 도구 실행 UI는 MCP 클라이언트가 결정한다. 사용자가 ‘박스티어로 영수증 만들어줘’, 농구 감열지 영수증, basketball game receipt, score receipt를 요청했고 팀명·최종 점수·경기 날짜·장소·경기 형식을 모두 실제 값으로 제공했을 때만 사용한다. 사용자가 엠블럼 이미지를 첨부하면 홈·원정에 맞춰 homeEmblemFile·awayEmblemFile로 전달한다. 원형 파일은 강제하지 않는다. 가능하면 투명 배경 정사각형 캔버스에 실제 도안만 담고 원형 테두리·회색 원판은 미리 넣지 않는다. 서버가 알파 전경의 실제 경계와 중심을 계산해 원형 안전영역 안에 비율 유지·자동 중앙 정렬하고 스타일 변환하며 저장하지 않는다. 경기사진은 지원하지 않으므로 boxtier.kr 영수증 페이지 이용을 안내한다. 누락값을 추측하지 말고 먼저 사용자에게 물어본다. 농구 외 경기, 허위 경기 기록, 상거래 영수증에는 사용하지 않는다.

ParametersstylevenuerequiredformatrequiredlocalepresetcommentawayTeamrequiredhomeTeamrequiredplayedOnrequiredawayScorerequiredhomeScorerequiredawayEmblem+8 more

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.