Everything on this page is public, stable and safe to poll. If you are an agent, start with llms.txt or openapi.json - they say the same thing in fewer tokens. To play the game from code, see the bot API.
Agents
Maps of the site, for crawlers and agents. All of them are static and free to poll.
GET /llms.txttext/plainWhat FOLK is, what it costs, where it runs, and every public page - stated directly instead of inferred from marketing copy.GET /llms-full.txttext/plainThe markdown representation of every page listed in llms.txt, the whole wiki included, concatenated for a single fetch.GET /sitemap.xmlapplication/xmlStandard sitemap. Includes the changelog permalinks, whose lastmod is the post's own date.GET /news/rss.xmlapplication/rss+xmlRSS 2.0 feed of everything on /news - articles and changelog posts, newest first.GET /robots.txttext/plainPublic content pages are open; the game, authoring tools, auth flows and API are not.GET /openapi.jsonapplication/jsonOpenAPI 3.1 description of every endpoint on this page.GET /.well-known/api-catalogapplication/linkset+jsonRFC 9727 linkset of every API on this domain - this one and the bot API - each with its OpenAPI spec and docs.
Identity
Records that prove folk.lol is who it says it is, on AT Protocol and standard.site.
GET /.well-known/site.standard.publicationtext/plainVerification endpoint for our site.standard.publication record: a reader only trusts the record if the AT-URI here matches it. https://standard.site/docs/verification/GET /api/atproto/client-metadata.jsonapplication/jsonServed from the live client so it cannot drift from config. Its URL is our client_id.GET /api/atproto/jwks.jsonapplication/jsonJSON Web Key Set for the OAuth client above.
App
Endpoints the shipped clients use, and which are public as a consequence.
GET /api/v1/timeapplication/jsonThe server's authoritative time of day and day counter - the same values the game world runs on. Never cached.GET /manifest.webmanifestapplication/manifest+jsonInstall metadata for the browser build.GET /downloads/{file}application/octet-streamStable, version-free path that redirects (302) to the current binary. Valid names are listed on /apps.
Markdown content negotiation
Every page listed in llms.txt has a markdown representation. Ask for it and you get it:
curl -H "Accept: text/markdown" https://folk.lol/about
Responses carry Content-Type: text/markdown; charset=utf-8 and Vary: Accept. Appending .md to a path (/about.md, /index.md for the home page) returns the same document whatever your Accept header says. A client that accepts neither HTML nor markdown gets a 406; an unknown path gets a 404 whose body is a markdown map of where to go instead. Implemented to acceptmarkdown.com.
AT Protocol
FOLK publishes to the AT Protocol network under the DID did:plc:ijmfftrkmxdxndel5hbxhzn3, with the handle folk.lol.
lol.folk.game- the self-asserted definition of the game, oneselfrecord in our repo.lol.folk.profile- a player’s FOLK profile, written into their own repo.- Badge definitions, published as records in the same repo.
- standard.site publication
at://did:plc:ijmfftrkmxdxndel5hbxhzn3/site.standard.publication/folk, verified by /.well-known/site.standard.publication. Long-form pages are mirrored assite.standard.documentrecords.
Elsewhere
What FOLK is, every way to play, and the FAQ. Bugs, questions and API requests: contact@folk.lol.

