# Foundplay for coding agents

Foundplay (foundplay.io) is a game discovery platform for free browser games. It lists games for free and links each one to the site where its maker published it; it doesn't host games.

## What an agent can do, and what only the person does

- An agent can read: whether a game is listed, its public plays and upvotes, and the Boost plans.
- An agent can prepare links: the free listing link with the play link filled in, and a Boost checkout link.
- Only the person signs in (with their email and a one-time code, or Google), publishes the listing and pays for a Boost on Stripe's checkout page. Nothing is listed or bought until they do.
- No API key or account is needed to read.

## Check whether a game is listed

`GET https://foundplay.io/api/games/lookup` with one of `url` (the game's play link), `slug` (the last part of its page address, /games/{slug}) or `page` (its Foundplay page address). JSON, no key.

```
curl "https://foundplay.io/api/games/lookup?url=https%3A%2F%2Fexample.com%2Fmy-game"
```

- Listed: `listed: true`, the page, public plays and upvotes, the date it was listed, whether its play link passed the last check, whether it can be boosted and a Boost link for each plan.
- Not listed: `listed: false` and `listForFree`, the listing link with the play link filled in.
- `status` also says when a game is waiting for a drop, in review, hidden because its link stopped working, or taken down.

## List a game for free

```
https://foundplay.io/submit?url={play link, URL-encoded}
```

- Listing is free. The person opens the link, signs in with their email (a one-time code), checks the details and publishes. Games that pass the checks can go live right away; some need review. New additions join a drop at 6 AM Pacific.
- Foundplay fills in the title, description and cover from the game's page; the person can change them.
- Accepted: a link where the game plays in a browser, on the maker's own site or itch.io page. No SDK and no exclusivity, and Foundplay doesn't host files.
- Not accepted: links to CrazyGames or Poki, and a link that doesn't load.
- Every link gets a safety check. It fails a site on a malware or phishing blocklist, a link that downloads a file instead of opening a game page, a page with a known in-browser crypto miner, a lapsed domain showing a parking page, and fake virus or tech-support warnings.
- Every listing needs a picture: the page's preview image, or an upload. The description is in English.

## See how a game is doing

- Public plays and upvotes: the lookup above. A play is a counted outbound click on Play, once per game per network a day. It is not confirmed gameplay or a count of unique people.
- The maker's own numbers, after signing in: [https://foundplay.io/me/games](https://foundplay.io/me/games) shows plays by day, the share of the page's visitors who press Play, how many players stay 45 seconds or more, and where visits came from. A weekly email sends the week's plays.

## Paid promotion, if the person asks for it

Boost sells counted plays from sponsored spots on Foundplay, each labelled Sponsored.

- Boost (`boost`): $10 for 30 plays within 5 days, counted from when it starts.
- Boost Plus (`plus`): $39 for 150 plays within 5 days, counted from when it starts.
- A play is a click on Play from a sponsored spot, counted the way Foundplay's public play counts are: once per game per network a day, and only if the click starts on a Foundplay page. These are counted outbound clicks, not confirmed gameplay or unique people.
- Plays not delivered in time are refunded automatically, in proportion, to the card that paid.
- Not eligible: fan games and copies of big franchises, gambling, adult content, token sales, and a game whose link is down.

Checkout link for a listed game:

```
https://foundplay.io/boost/new?game={slug}&plan={planId}
```

For a game not listed yet (it is listed for free first, then the link returns to payment):

```
https://foundplay.io/boost/new?url={play link, URL-encoded}&plan={planId}
```

Plan ids: `boost`, `plus`. The person signs in and pays on Stripe's checkout page. Live availability, placements and the full terms: [https://foundplay.io/api/boost](https://foundplay.io/api/boost) and [https://foundplay.io/advertise](https://foundplay.io/advertise).

## MCP servers

The creators server at `https://foundplay.io/mcp/creators` does the same reads as MCP tools: `get_launch_checklist` (what to go through before and after a game goes live), `check_game`, `get_listing_link` and `get_boost_options`. In clients that show MCP prompts, `publish_browser_game` starts the whole walk-through. Its tools only read and return links. No sign-in.

Claude Code:

```
claude mcp add --transport http foundplay-creators https://foundplay.io/mcp/creators
```

Cursor, in mcp.json:

```
{"mcpServers":{"foundplay-creators":{"url":"https://foundplay.io/mcp/creators"}}}
```

VS Code, in .vscode/mcp.json:

```
{"servers":{"foundplay-creators":{"type":"http","url":"https://foundplay.io/mcp/creators"}}}
```

Gemini CLI, in its settings:

```
{"mcpServers":{"foundplay-creators":{"httpUrl":"https://foundplay.io/mcp/creators"}}}
```

The players' server at `https://foundplay.io/mcp` searches games to play. Setup for assistants: [https://foundplay.io/connect](https://foundplay.io/connect).

## Machine-readable files

- [https://foundplay.io/llms.txt](https://foundplay.io/llms.txt): the site for AI assistants, in Markdown.
- [https://foundplay.io/openapi.json](https://foundplay.io/openapi.json): the games search, the lookup and the Boost data.
- [https://foundplay.io/api/boost](https://foundplay.io/api/boost): Boost plans, terms and live availability as JSON.
- [https://foundplay.io/agents.md](https://foundplay.io/agents.md): this page in Markdown.
