MCP 服务器

arcadey-mcp

MCP server for managing games on coolgptgames.com, enabling agents like Claude to publish, update, and track games via the Arcadey API.

README

Cool GPT Games — SDK, CLI & MCP

Official developer tooling for publishing and managing games on coolgptgames.com. Everything here talks to the public Arcadey API (https://api.coolgptgames.com) with an API key you mint from your dashboard → API keys.

This repo contains four packages, all dependency-free (Node built-ins + fetch):

Package	What it is
`@arcadey/sdk`	Typed TypeScript client for the publishing API (create, upload, publish, track, tournaments, webhooks).
`arcadey`	Command-line tool — publish from your terminal or CI.
`arcadey-mcp`	MCP server so Claude / agents can manage your games.
`@arcadey/game-sdk`	Source + types for the in-game `GameSDK` bridge (already served to every game at `https://cdn.coolgptgames.com/sdk/game-sdk.js`).

Quickstart

Mint a key (arc_live_…) at coolgptgames.com/dashboard/keys, then:

SDK (Node / TypeScript)

import { ArcadeyClient } from "@arcadey/sdk";

const arc = new ArcadeyClient({ apiKey: process.env.ARCADEY_API_KEY! });

const { slug, status, playUrl } = await arc.publish({
  title: "My Game",
  category: "arcade",
  files: [{ path: "index.html", content: "<html>…</html>" }],
});

The client defaults to the production API. Point it elsewhere with new ArcadeyClient({ apiKey, baseUrl }).

CLI

arcadey login arc_live_xxx      # saves ~/.arcadey/config.json
arcadey publish ./my-game       # zips the folder, reads my-game/game.json
arcadey status <gameId>         # status + moderation feedback
arcadey games                   # list your games

Set ARCADEY_API_URL to override the API origin.

MCP (Claude / agents)

ARCADEY_API_KEY=arc_live_xxx arcadey-mcp

In-game SDK

Inside a game bundle, include the bridge (served from the game CDN) and call the GameSDK global:

<script src="https://cdn.coolgptgames.com/sdk/game-sdk.js"></script>
<script>
  GameSDK.ready();
  GameSDK.trackEvent("level_complete", { level: 3, score: 900 });
</script>