# Study Guild

> Study Guild is a shared flashcard community. Members join guilds (one shared deck per subject), add and improve cards, vote the best ones up, and study them with the Leitner system, climbing every card from F-Rank to S-Rank.

## How it works

- A guild is a shared pool of cards on one subject, at https://studyguild-qokwbz0qzdvqempnozgziw5r.gaaf.kaperkun.de/guilds/{slug}. Anyone signed in can add a card or improve any card's wording; each edit is a new version, and learners who already hold a card keep the wording they learned.
- Near-duplicate cards are blocked by meaning: the existing card is shown with an offer to upvote it instead.
- Joining a guild creates the member's stack: a few new cards a day (the flow rate, in order or shuffled, above a chosen minimum score) plus every card the member writes.
- Leitner ranks: F-Rank Recruit (review daily), D-Rank Apprentice (every 2 days), C-Rank Adept (4 days), B-Rank Vanguard (8 days), A-Rank Elite (16 days), S-Rank Legend (mastered, checked every 30 days). A correct answer on a due card climbs one rank; a miss drops the card back to F-Rank.
- Streaks, a daily goal, Guild XP levels and a public contributor leaderboard (https://studyguild-qokwbz0qzdvqempnozgziw5r.gaaf.kaperkun.de/leaderboard) keep score. Authors earn the score of their cards.

## AI connector (Model Context Protocol)

- MCP server (Streamable HTTP, OAuth 2.1 with dynamic client registration and Client ID Metadata Documents): https://studyguild-qokwbz0qzdvqempnozgziw5r.gaaf.kaperkun.de/mcp
- Scopes: studyguild:read (browse and search), studyguild:write (create guilds, add cards, vote).
- Tools: list_guilds, get_guild, search_cards, create_guild, add_card, add_cards (up to 50 at once), vote_card.
- add_card and add_cards report duplicates as results with the matching card, never as errors; upvote the match with vote_card instead of rephrasing it.

## Pages

- [Home](https://studyguild-qokwbz0qzdvqempnozgziw5r.gaaf.kaperkun.de/)
- [All guilds](https://studyguild-qokwbz0qzdvqempnozgziw5r.gaaf.kaperkun.de/guilds)
- [Leaderboard](https://studyguild-qokwbz0qzdvqempnozgziw5r.gaaf.kaperkun.de/leaderboard)
- [Sitemap](https://studyguild-qokwbz0qzdvqempnozgziw5r.gaaf.kaperkun.de/sitemap.xml)

## Largest guilds

- [Dutch Language](https://studyguild-qokwbz0qzdvqempnozgziw5r.gaaf.kaperkun.de/guilds/dutch) (LANGUAGES, 5 cards, 1 member): For English Learners interested in learning the Dutch Language - Front of card should be the English version of the word, if it's a noun include "The" - Back o…