GetCourt

Status

Website: https://getcourt.co/

GetCourt is a simple app to bring together the community of people who play tennis.
Create and join court games, manage courts, invite players, and receive Telegram reminders and notifications.

Main features

• Create and manage recurring or one-off games and trainings, with or without a coach
• Discover and open new local courts, suggest edits to the ones already listed
• Book slots ahead of an upcoming game and cancel them
• Run tournaments and collect match statistics that feed overall player ratings
• Search for coaches and launch player searches
• Find suitable opponents with AI-based matching, read scores off a photo of the scoreboard
• Share photos and clips from a game and follow the Tennis Life feed
• Telegram bot integration for notifications and registration tokens
• Mobile-friendly UI with map integration and simple search
• Public JSON API over upcoming games and an MCP server on top of it

Main technologies

• Ruby 4.0 / Ruby on Rails 8.1
• Hotwire (Turbo + Stimulus) for interactivity, Propshaft + importmap for assets
• Tailwind CSS for styling
• SQLite for development and production
• Solid Queue / Solid Cache / Solid Cable for jobs, caching and websockets
• Active Storage with libvips for photos and clips
• RubyLLM (Gemini) for the AI features
• Google / Nominatim geocoding for addresses, Google Maps for the pickers

Public API and MCP

Upcoming games are readable from outside the app in two ways:

• GET /api/v1/games and GET /api/v1/games/:id — public JSON, no key needed
• POST /mcp — an MCP server (JSON-RPC 2.0 over Streamable HTTP) with search_games and get_game tools; the handshake and tools/list are open, tool calls need a bearer token (a personal one from Account → Security, or the shared MCP_TOKEN)

Both are read-only and expose only what a game page already shows in public. See docs/api-and-mcp.md for parameters, examples and limits, or the same documentation for users at getcourt.co/api-and-mcp.

Tests and coverage

bin/rails test          # unit, model and controller tests
bin/rails test:system   # system tests, needs Chrome
bin/rubocop             # style, same as CI

Coverage is generated during Minitest runs and saved to coverage/summary.txt.

License

This project is licensed under the Apache License 2.0.
See the LICENSE file for details.

Note on Trademarks:
The "GetCourt" name, logo, and associated branding are trademarks of the project author. While the code is open source, this license does not grant permission to use these trademarks to endorse or promote products derived from this software without prior written permission.