The official MCP server connects Frolick to Claude, ChatGPT, Cursor and any Model Context Protocol client. Ask your assistant to build a game, content set, widget or classroom board — in a chat, in your code editor or in the terminal, on your behalf.
Create a flashcards game from my Unit 3 vocabulary set.
Flashcards game created in your account
flashcardsMCP is an open standard, so any client that speaks it can talk to Frolick. Teachers don’t need a code editor: connect Frolick straight to a chat assistant in the browser or on your phone.
Connect by URL in a couple of clicks — no install, no tokens. Works on the web, on desktop and in mobile apps.
The classic setup: the assistant in your editor builds games and content sets while you work on course material.
Terminal agents and scripts: bulk content imports, scheduled game generation, routine automation.
This list is not exhaustive: any client that supports the Model Context Protocol works — remote by URL, or via the local stdio server.
MCP (Model Context Protocol) is an open standard that lets AI assistants use external tools. The Frolick MCP server is a thin proxy over the public API: on startup it fetches a live capability manifest from the platform and registers the current tools automatically. Your assistant reads and creates things in your account — no browser, no copy-paste.
Tools are loaded from a live manifest: new platform capabilities appear on their own, without updating the package or restarting the client.
Everything is created in your own Frolick account — via OAuth authorization or a personal access token, both under your control.
The @frolick/mcp package is open source and ships no business logic — only how to call the public, documented API.
Roughly three dozen teacher-facing tools plus two catalog resources. A few highlights:
Generate any of the seven Frolick game types — checkers, four-in-a-row, dobble, tic-tac-toe, flashcards, quiz and bingo — with content inline or pulled from a content set.
Create sets, add rows, batch-fill field values, import structured data in one call, duplicate, and list game types compatible with a set.
Author templates, convert them between board game types, and link a content set with field mappings so one template drives many games.
Create standalone widget instances, save style presets, and assemble multi-widget classroom boards — timers, dice, scoreboards, polls and more.
List and read your profile, content sets, templates, games, widget instances and boards so the assistant works with what you already have.
Two read-only resources — the game catalog and the widget-type catalog — let the assistant discover valid types and content models before it builds.
Copy a prompt and paste it to your assistant once connected — or write your own.
Quick remote access by URL with OAuth — or a local stdio server with a token when you want full control.
Point your client at the server URL — it shows an authorize button, you approve access on frolick.ru, and you’re connected. No token to paste, and it refreshes itself.
https://app.frolick.ru/api/v1/mcpThe client runs the stdio server via npx and calls the API with your personal access token. For clients without OAuth, CI and scripts. Requires Node.js 18+.
npx -y @frolick/mcp
Pick a client — a couple of minutes later the assistant is building your lesson.
Claude, ChatGPT, Cursor, VS Code, the terminal — the instructions on the right adapt to your choice.
For a remote connection, approving access with the button in your client is enough. For a local one, create a personal access token (starts with pat_) and drop it into the config.
Open API tokensFor example: “Create a flashcards game from my Unit 3 vocabulary set” — or grab a ready-made prompt from the section above.
Open claude.ai → Settings → Connectors.
Click “Add custom connector” and paste the server address.
Click Connect and approve access in the frolick.ru window that opens.
Enable the Frolick tools in the chat’s tools menu and ask the assistant to build a lesson.
https://app.frolick.ru/api/v1/mcpCustom connectors are available on paid Claude plans and also work in the mobile app.
Environment variables read by the @frolick/mcp stdio server.
| Variable | Default | Purpose |
|---|---|---|
| FROLICK_API_TOKEN | required | Personal access token (pat_…). Required for anything that touches your account. |
| FROLICK_API_BASE_URL | https://app.frolick.ru | API origin the server reads the manifest and sends calls to. |
| FROLICK_MCP_TIMEOUT_MS | 15000 | Per-request timeout in milliseconds. |
| FROLICK_MCP_REFRESH_MS | 300000 | Manifest refresh interval — new tools appear without a restart; 0 disables it. |
| FROLICK_MCP_READONLY | — | Set to 1 to expose only read tools and hide every mutating tool. |
Nothing to configure for the remote URL connection: authorization runs over OAuth and the server refreshes the manifest on its own.
The MCP is free. What you can build depends on your Frolick plan.
The @frolick/mcp package is MIT-licensed and free to use. There is no separate charge for connecting it to your assistant.
Your Frolick subscription — Free, Silver or Gold — decides which games, widgets and limits apply. The assistant can call list_billing_plans to read the current plans live.
Public reads like the plan list and public templates, plus the game and widget catalogs, work without any authorization at all.
What the server deliberately does not do.
Only teacher-facing endpoints are exposed. Admin, billing-internal, AI, chat and media APIs are never reachable through the MCP.
Access acts on your behalf and only your own data. It carries no elevated or organization-wide permissions.
Reusable templates support checkers, four-in-a-row and dobble. For quiz, flashcards, bingo and tic-tac-toe, create the game directly.
Some widgets and capabilities require a paid plan. Tools return the platform’s normal errors when your plan doesn’t include a feature.
Requests go through the standard public API and are rate-limited. Each call times out after 15s by default (configurable).
Prefer a safe setup? Set FROLICK_MCP_READONLY=1 and the local server hides every tool that can change your data.
No. The easiest way is to connect Frolick to a chat assistant: Claude.ai (including the mobile app), Claude Desktop, or ChatGPT in developer mode. Editors and the terminal are just one of the scenarios.
Any Model Context Protocol client — Claude.ai, Claude Desktop, ChatGPT, Claude Code, Cursor, VS Code, Windsurf, Zed and more. Connect remotely by URL or run the local stdio server, your choice.
Remote is a URL with OAuth authorization: nothing to install, the token refreshes itself and access is revoked in settings. Local runs the server via npx with a personal access token — handy for CI, scripts and clients without OAuth.
For remote — no: the client connects to https://app.frolick.ru/api/v1/mcp directly. For the local server you only need Node.js 18+ — npx downloads the latest @frolick/mcp on demand.
The server only calls Frolick’s public API on your behalf. Admin and internal endpoints are unreachable, OAuth access is revoked in one click, and the local server can run read-only.
Yes. The tool list comes from the platform’s live manifest, so new Frolick capabilities appear automatically — no package upgrade needed.
Yes — public read tools and the game and widget catalogs work without authorization. Connect your account when you want the assistant to create things on your behalf.
A couple of minutes — and AI builds your next lesson: in a chat, an editor or the terminal.