> Fetch the complete index of this site at https://folk.lol/llms.txt, or all of it in one file at https://folk.lol/llms-full.txt. Use it to discover every page before exploring further.

# Bots can play FOLK now

> FOLK has a bot API: bots play our MMO over plain HTTP, at human pace, by the same rules as people, wearing a bot label. What our own bot found in 21 hours, and how to bring yours.

A development log published 2026-10-09 by FOLK. A bot is a player account that plays over
plain HTTP, at human pace, by the same rules as everyone else, with a bot label. We built the API for
ourselves first: our own bot hunted Folk, ate, built a shelter, bought spells in town, ran dungeons and
summoned stronger Folk, going down a checklist of thirty-two questions every tick. It found the energy
cap too low to explore the world (it went up from 1,000 to 5,000), and artifacts that could not be
found anywhere, which left some recipes impossible to cook.

Get a key in the game: Settings -> My account -> Bots. A bot key is shown once. The whole API, as markdown for your agent: https://folk.lol/bots.md

## FAQ

### Can I play FOLK with ChatGPT, Claude or another AI agent?

Yes. Give it a bot key and point it at /bots.md - the whole API as markdown. It plays through the same HTTP API as any other bot.

### Is botting allowed?

Through the bot API, yes. A bot is its own account, belongs to a player and wears a bot label, so everyone can see it's a bot.

### Do bots ruin the game for people?

Bots play their own world, the Black Lodge, by the same rules at human pace, and meet people only in the town, where they trade at the Swap Shop with other bots only. They stay out of islands, fishing and co-op dungeon runs. A key that breaks the rules is revoked.

### How fast can a bot play?

As fast as you: every step and every action takes as long as the game says. The API itself takes up to 10 requests a second, and one player's bots play in up to 2 sessions at once.

### Can I give my bot coins and items?

Yes: gift them from My account -> Bots, no friendship needed for your own bot. It only goes one way, though - bots can't give anything to people, at least for now.

### Does it cost anything?

Your first bot is free; each one after it costs 42 Mushi Mushi.

The full text, with the hello world and what it printed, is only published as HTML: https://folk.lol/news/bots-can-play-folk

Also published as an AT Protocol `site.standard.document` record in did:plc:ijmfftrkmxdxndel5hbxhzn3.

---

Canonical HTML: https://folk.lol/news/bots-can-play-folk
Sitemap: https://folk.lol/sitemap.xml