Courtship
Token-efficient MCP runtime and proxy for agents that build and debug LOVE games
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 1.0.2
- Listing updated
- today
Similar MCP servers
About Courtship
Courtship is an MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Courtship is a single static binary, called court, that sits between an agent and a running LOVE (Lua) game. Instead of exposing every game tool at once, it keeps five small meta-tools in context, about 340 tokens by the README's count, and loads the rest on demand.
For the game it offers input simulation, deterministic frame stepping, screenshots, entity listings, Lua evaluation and crash recovery. A crash is caught so the connection stays up, and the agent can read the trace, fix the code and hot-reload. A shaper trims responses, with measures such as field projection, depth capping, array slicing and downscaled screenshots. court run wraps a game without changing the repository.
The README reports a 76.5 percent cut in standing context and 53.4 percent less per-task token use against a comparison server. It can also proxy other MCP servers and ships a benchmark command.
Install
Run in a terminal
claude mcp add courtship -- docker run -i --rm ghcr.io/grimmdev/courtship:1.0.2Add to claude_desktop_config.json
{
"mcpServers": {
"courtship": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/grimmdev/courtship:1.0.2"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"courtship": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/grimmdev/courtship:1.0.2"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"courtship": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/grimmdev/courtship:1.0.2"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"courtship": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/grimmdev/courtship:1.0.2"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"courtship": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/grimmdev/courtship:1.0.2"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- discover_tools
- Finds available tools by query without loading schemas.
- load_tool_schema
- Loads one tool's full schema on demand.
- call_tool
- Runs a tool through the response shaper.
- love_task
- Routes a goal to docs, inspection or execution.
- report_usage
- Reports session token, call and latency counts.
What it does
- Small standing surface
- Five meta-tools keep context light.
- Agent joypad
- Sends timed key presses to the game.
- Frame stepping
- Advances physics by exact frame counts.
- Crash recovery
- Keeps the bridge alive and returns stack and locals.
- Response shaping
- Prunes and caps results to save tokens.
- Offline docs index
- Searches LOVE 12 API docs locally.
Good for
- Let an agent play-test a platformer
- Debug a Lua crash without restarting
- Check physics by stepping frames
- Cut token cost for game tasks
- Benchmark two MCP servers on one task
Courtship FAQ
How do I run it?
Use the court binary with court proxy, or the Docker image ghcr.io/grimmdev/courtship.
Does it need game changes?
court run wraps a game with no repository changes; court init gives a manual hook.
Which engine?
LOVE, with LOVE 12 docs.
Are the savings guaranteed?
They are the author's measurements.
How do I add Courtship to Claude Code?
Run this command in your terminal: claude mcp add courtship -- docker run -i --rm ghcr.io/grimmdev/courtship:1.0.2
What are the best alternatives to Courtship?
The closest alternatives to Courtship are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


