Skip to content
MCP server

Courtship

Token-efficient MCP runtime and proxy for agents that build and debug LOVE games

Runs locallyStatus and history
Install
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.2

Add to claude_desktop_config.json

{
  "mcpServers": {
    "courtship": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/grimmdev/courtship:1.0.2"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "courtship": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/grimmdev/courtship:1.0.2"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers