# The Git List (gitlist.dev)

The Git project's development mailing list, git@vger.kernel.org, from April 2005 to now.
New mail is fetched from lore.kernel.org every hour. An AI editor writes a front page each morning.

## MCP server

Endpoint (Streamable HTTP): https://gitlist.dev/api/mcp

Tools:
- search_messages(query, author?, since?, until?, patchesOnly?, sort?, limit?, offset?)
- recent_threads(limit?, before?)
- get_thread(threadId): the whole thread as Markdown, with full bodies and patches
- get_message(messageId)
- front_page(): this week's curated stories

Example client config:
  { "mcpServers": { "gitlist": { "url": "https://gitlist.dev/api/mcp" } } }

## HTTP API (JSON, no key needed)

- GET /api/search?q=...&author=...&since=YYYY-MM-DD&until=YYYY-MM-DD&patches=1&sort=newest&limit=25&offset=0
  q uses web-search syntax: "quoted phrases", OR, -exclude.
  Each result has the thread id and a snippet with matches marked «like this».
- GET /api/threads?limit=50&before=<ISO time>   recently active threads
- GET /api/threads/<id>                          a thread and all its messages
- GET /api/threads/<id>?format=md                the same as Markdown
- GET /api/messages?id=<Message-ID>              one message
- GET /api/front                                 this week's front-page stories (headline, dek, short overview, full summary)

## Web pages

- /s/<id>               a front-page story in full
- /t/<id>               read a thread
- /m?id=<Message-ID>    jump to a message within its thread
- /search?q=...         search
- /threads              recent threads

Please be gentle: cache results where you can. The original archive is at https://lore.kernel.org/git/.