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 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 and 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.

Machine-readable files