# Using the founder-dinner MCP server

dinner.youcanjustdothings.io exposes founder dinner-table matching over a Model Context Protocol server at
`https://dinner.youcanjustdothings.io/mcp`. Two tools, no authentication, rate-limited at 60 requests / 60s per IP. It speaks streamable HTTP per
MCP spec revision `2025-06-18` and is stateless, so plain JSON-RPC over curl works the same as an MCP-aware client.

## Quick reference

```bash
# 1. initialize
curl -sS https://dinner.youcanjustdothings.io/mcp -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' -d '{
  "jsonrpc":"2.0","id":1,"method":"initialize",
  "params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"demo","version":"0.1"}}
}'

# 2. list tools with full input schemas
curl -sS https://dinner.youcanjustdothings.io/mcp -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. call a tool
curl -sS https://dinner.youcanjustdothings.io/mcp -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' -d '{
  "jsonrpc":"2.0","id":3,"method":"tools/call",
  "params":{"name":"match_founders","arguments":{"Max Seats":10,"Mode":"fill"}}
}'
```

## Tools

### match_founders

Seats the 574 stored founders. Arguments (all optional, with defaults): `Weights` (Balance: Age/Role/Education/Vertical,
Separation: Group/Section, each 0-5), `Max Seats` (8-10), `Mode` (`fill` or `mix`).

### match_founder_list

Seats a caller-supplied list. Provide the founders exactly one of two ways:

- `Founders`: an inline array of source records (Id, Name, Group, "Group Section", "Company vertical", Company, Age,
  Education, Role).
- `Founders_url`: an https URL to a JSON array of those records; the server fetches (5 MB / 10s caps) and validates it.

Plus the same `Weights` / `Max Seats` / `Mode`. Lists are capped at 2,000 founders and validated against
https://dinner.youcanjustdothings.io/api/schema/input.json; invalid input fails fast.

## Output

Both tools return the output document (https://dinner.youcanjustdothings.io/api/schema/output.json): run metadata plus one assignment per founder
carrying only `Table`, `Name`, and `Company`. Other founder attributes are PII and never leave the server.