Snowbll Docs

Set up Snowbll in minutes.

Everything here assumes nothing: if you've never installed a developer tool before, start at the top and follow the steps in order. And if you don't want to install anything at all — that's fine, Snowbll works in the browser and over plain HTTP too.

Connect an AI agent No-install options

Paste this into any AI agent

Prepares an MCP-capable agent for the Snowbll developer preview.

Agent setup prompt

Set up the Snowbll MCP server for developer-preview access.

Important:
- snowbll-mcp is in developer preview.
- API keys are developer-preview credentials, not a generally available account feature.
- The live public API today is POST https://snowbll.com/api/search and it does not require a key.

1. Confirm the Snowbll team has issued this account a developer-preview API key.

2. Install and run setup:
npm install snowbll-mcp
npx snowbll-mcp setup

When setup asks for a key, paste the developer-preview API key.

3. Add this MCP server to the agent's MCP config:
{
  "mcpServers": {
    "snowbll": {
      "command": "npx",
      "args": ["-y", "snowbll-mcp"],
      "env": {
        "SNOWBLL_API_KEY": "sb_YOUR_API_KEY"
      }
    }
  }
}

If the agent supports a CLI MCP add command, use:
claude mcp add snowbll -- npx -y snowbll-mcp

After restarting the agent, verify the connection with a read-only
search_games call, for example:
"economy sim like Lemonade Tycoon with a deep economy".

Get started

Create your account

Go to snowbll.com/signup.
Sign up with email and password, or continue with Google or Discord.
That's it — the starting rank (Traveler) is free, and one account works across the marketplace, The Forge, the community, and these docs.

You only need an account for personalized features (your persona, backing campaigns, posting). Searching the catalog works without one.

Get started

Choose how you'll use Snowbll

There are three ways in, and installing anything is optional:

Path	Install needed?	Status
The website — search, persona, The Forge	Nothing to install	Live
An AI agent via MCP (`snowbll-mcp`)	One npm package	Developer preview
Plain HTTP — call the search API from any tool	Nothing to install	Live

If you just want to find games, use snowbll.com and skip the rest of this tab. The sections below are for connecting an AI agent or calling the API.

Connect an AI agent

One-paste setup

The card below is a complete setup prompt. Copy it, paste it into your AI agent (Claude Code, Claude Desktop, or any MCP-capable agent), and the agent walks itself through the installation.

Click Copy on the agent setup prompt card.
Paste it into a chat with your agent.
When the agent asks for a key, paste your developer-preview API key (issued by the Snowbll team to preview participants).
Restart the agent so it picks up the new MCP server.

Developer preview. This surface is not generally available yet; names, fields, auth, and quotas may change before launch. The live, no-key endpoint is documented under Search.

Connect an AI agent

Manual configuration

Prefer doing it by hand? You need two things first:

Node.js 18 or newer — check with node -v in a terminal; install from nodejs.org if the command isn't found.
A developer-preview API key — issued by the Snowbll team while the preview runs; keys are not a generally available account feature yet.

Install the server

npm install snowbll-mcp
npx snowbll-mcp setup

Then register the server in your agent's MCP configuration (the file or settings screen where your agent lists its MCP servers):

MCP config

{
  "mcpServers": {
    "snowbll": {
      "command": "npx",
      "args": ["-y", "snowbll-mcp"],
      "env": {
        "SNOWBLL_API_KEY": "sb_YOUR_API_KEY"
      }
    }
  }
}

Agents with a CLI shortcut can use one line instead: claude mcp add snowbll -- npx -y snowbll-mcp.

Connect an AI agent

Verify it works

Restart your agent, then ask it something a player would ask:

Try it

Use search_games to find: "economy sim like Lemonade Tycoon with a deep economy"

A working setup returns a short list of candidates, each with reasons explaining the match. If it doesn't:

Tool not found — the agent didn't reload its MCP config; restart it fully.
Auth error — the key was pasted wrong or revoked; re-run npx snowbll-mcp setup with a valid preview key.
`node` not found — install Node.js first (see Manual configuration).

No install needed

Use the API directly

The search endpoint is live and needs no key — any tool that can send an HTTP request can use Snowbll today:

One request, no setup

curl -s -X POST https://snowbll.com/api/search \
  -H "content-type: application/json" \
  -d '{"query": "cozy farming sim with deep crafting"}'

Full request/response details live in the developer tab: Search.

No install needed

Troubleshooting

Setup steps fail halfway — run them one at a time and read the first error, not the last.
Behind a corporate proxy, npm install may need your proxy configured first.
Still stuck? Ask in the community — the Snowbll Discord is linked in the site footer.