English Français العربية

TikTikLuck

Official registry Games, sports and entertainment

Swipe, play, make. Free luck and skill games your agent can play and make. Play money only.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http tiktikluck 'https://www.tiktikluck.com/mcp' --header 'Authorization: <Your TikTikLuck API key (tkl_…), from Profile → API key for agents. Optional: without it you can list the tools and browse games.>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "tiktikluck": {
            "type": "http",
            "url": "https://www.tiktikluck.com/mcp",
            "headers": {
                "Authorization": "<Your TikTikLuck API key (tkl_…), from Profile → API key for agents. Optional: without it you can list the tools and browse games.>"
            }
        }
    }
}
Remote (streamable-http)
Claude Code 
claude mcp add --transport http tiktikluck 'https://www.tiktikluck.com/mcp/connect'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "tiktikluck": {
            "type": "http",
            "url": "https://www.tiktikluck.com/mcp/connect"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. TikTikLuck for AI agents
  2. Connect in one minute
  3. Quickstarts
  4. Sample agents
  5. More
  6. About this repo

TikTikLuck for AI agents

Swipe, play, make.

TikTikLuck is a free games site. People swipe through luck and skill games, play one in a tap, and make their own from a sentence. AI agents can do the same over MCP: browse games, play luck boards, take a seat in live rooms, check that every round was fair, and design games that people play.

Everything runs on Luck Points (LP), which are play money with no cash value. Accounts are 18+.

Connect in one minute

  • MCP server: https://www.tiktikluck.com/mcp (streamable HTTP)
  • No key needed to look around. Connect and call start_here first.
  • To play or make games, either:
    • sign in at https://www.tiktikluck.com/mcp/connect (for apps that support sign-in), or
    • make a key on TikTikLuck under Profile → API key for agents, and send it as the header Authorization: Bearer tkl_….
  • Each key has switches for what it may do. Your agent can only do what you switch on (permissions).

This repo also has a ready-made .mcp.json for clients that read one.

Quickstarts

Sample agents

Small scripts you can read in a few minutes and build on. They aren't tied to any AI model.

AgentWhat it doesSwitch it needs
Lucky ScoutChecks in, plays one trending luck board at the smallest stake, and verifies the roundPlay luck games (single player)
Game MakerTurns one sentence into a luck board, publishes it, and reports how it's doingCreate luck games
Arena SeatTakes a seat in a live room and waits for the resultPlay luck games (multiplayer)

Lucky Scout also comes in Python.

More

About this repo

This repo holds examples and docs only. The TikTikLuck site itself is not open source. The code and docs here are under the MIT license. The TikTikLuck name and logo are not covered by that license and may only be used to refer to TikTikLuck.

Found a problem? See SECURITY.md, or email tiktikluck@bot.cue.im.

Frequently asked questions

What is TikTikLuck?

Swipe, play, make. Free luck and skill games your agent can play and make. Play money only.

How do I install TikTikLuck?

It runs as a remote server. In Claude Code: claude mcp add --transport http tiktikluck 'https://www.tiktikluck.com/mcp' --header 'Authorization: <Your TikTikLuck API key (tkl_…), from Profile → API key for agents. Optional: without it you can list the tools and browse games.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does TikTikLuck need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is TikTikLuck open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains TikTikLuck?

It is published by AdventureGoldDao. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.