Sonic PHP 0

Make with an AI

The site has an MCP server (Model Context Protocol, the standard that links an AI to tools). An AI connected to your account with an API key can make a whole game world: tiles (the blocks of the scenery and how solid they are), a level, sprites (Sonic redrawn), a music and sound effects. It can look at what it made (a picture of the level), test it (a bot plays a "fake game" and says where it gets stuck), fix it, then publish it on your account, private or public.

All it makes is in your name, as if you had made it in the editor. You find it on your profile, you can change it by hand, and the history says what the AI did, and with which key.

1. An API key

You need an account: Log in or Sign up, then make a key on the "API keys" page (menu, "AI and API keys").

A "read only" key can look at and test everything, but not make or change anything. To make levels, pick "read and make".

2. Connect the AI

Address of the MCP server (HTTP transport, "Streamable HTTP"): https://sonic.mimichat.fr/mcp
The key goes in the header Authorization: Bearer sk_sonic_.... Replace sk_sonic_... with your key.

Claude Code

claude mcp add --transport http sonic https://sonic.mimichat.fr/mcp --header "Authorization: Bearer sk_sonic_..."

Then run claude and check with /mcp.

Claude Desktop

Settings, Developer, Edit config (claude_desktop_config.json). Node.js (npx) is needed.

{
  "mcpServers": {
    "sonic": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://sonic.mimichat.fr/mcp", "--header", "Authorization:${SONIC_AUTH}"],
      "env": { "SONIC_AUTH": "Bearer sk_sonic_..." }
    }
  }
}

Cursor, Windsurf, Gemini CLI…

In the MCP config (for example ~/.cursor/mcp.json):

{
  "mcpServers": {
    "sonic": {
      "url": "https://sonic.mimichat.fr/mcp",
      "headers": { "Authorization": "Bearer sk_sonic_..." }
    }
  }
}

VS Code (Copilot)

.vscode/mcp.json

{
  "servers": {
    "sonic": {
      "type": "http",
      "url": "https://sonic.mimichat.fr/mcp",
      "headers": { "Authorization": "Bearer sk_sonic_..." }
    }
  }
}

3. Ask it

A few ideas of what to ask:

The AI starts by reading the server's manual (the get_reference tool): formats, Sonic's physics, collision shapes, objects, music. It works as in the editor: make, look, test, fix.

What the AI can do (24 tools)

Account

whoami
The account this key acts for, what the key may do, how many creations of each kind it has and may have. Start here.
get_reference
How the game and its editors work: formats, rules, physics, collision shapes, objects, music, a way to work. Read "workflow" first, then what you need. Topics: workflow, level, objects, tiles, shapes, behaviours, sprites, music, sfx, testing.
list_creations
Lists levels, tilesets, sprites or sounds: this account's ("mine"), those it was added to ("shared"), the public ones of everybody ("public"), the zones of the game (tileset, "zones"), what is in its trash ("trash"), or the levels in its favourites ("favourites"). Public levels: sort "top" (the best rated, default), "new", "plays" (the most played), "fav" (the most often in favourites), and search (in their names and authors). A level shows its rating (the average of the players' stars, 1 to 5), votes, plays and favourites.
get_history
Every action on a creation, the latest first: who, when, what changed (with the name of the API key when it was done through the API).
fork writes
Makes this account's own copy of a creation it can see (a zone of the game, a public creation, its own): the copy says where it comes from. The way to change what is not this account's.
set_public writes
Makes a creation of this account public (everybody sees it, may play it and fork it) or private (only the account and the players it added). Do it only when the player wants it published.
trash writes
Puts a creation of this account in its trash: hidden from the others, kept 30 days, the player can restore it (restore). Its forks and the levels made with it keep working. Nothing is deleted for good through the API.
restore writes
Takes a creation of this account out of its trash, as it was.

Levels

get_level
A level: its settings, objects, start, and its blocks: "map" (default) a text map, one character a block, with a legend (what is solid, slopes, rings, springs, objects), or "numbers" (the indexes of its tileset, rows from the top). A region reads a part.
create_level writes
A new level on this account (private). With a tileset (yours, a public one or a zone of the game) and a size: empty, with a flat ground of 3 rows (ground true); or template: a copy of the act 1 of a zone (green-hill, bridge, jungle, labyrinth, scrap-brain, sky-base, bonus). Then edit_level.
edit_level writes
Changes a level of this account (or one it was added to): operations on its blocks and objects, then settings. All or nothing: if one operation is wrong, nothing is changed. Saved in its history (taken back on the site if needed).
render_level
A picture of a level as the game draws it (smaller: px pixels a block; 32 is the game's size), with its objects and Sonic at his start. collision: tints what is solid (red: floor, orange: walls, violet: only a ceiling). grid: lines between blocks. times: the animated blocks (water, waterfalls) at these moments, in seconds: one picture each (4 at most), to see them move.
test_level
A fake game: a bot with the physics of the game plays the level (2 tries: fast, careful) and says if it reaches the goal, where it got stuck or died, with its path on a picture; and checks the level (start, objects in walls or in the air, goal, rings). Badniks stand still and platforms do not move in it. Use it after each big change.

Musics and sounds

get_sound
A music or a sound effect: its data (the format of get_reference "music" / "sfx") and its length.
create_sound writes
A new music or sound effect on this account (private), made from its data; the site renders it as the game plays it. A level uses it with edit_level (set.music_sound_id, set.sfx).
edit_sound writes
Changes the data (all of it) and/or the name of a sound of this account; rendered again for the game.

Sprites

get_sprites
A set of sprites: which sheets it redraws (the others are the game's), their sizes.
get_sprite_sheet
A sheet of a set of sprites (id) or of the game (no id): as an image (scale 1-4), or a region of it as pixel art text (128 x 128 pixels at most) to see the exact colours before recolouring or drawing.
create_sprites writes
A new set of sprites on this account (private), with the game's sheets. Change them with edit_sprites; a level plays with it when its sprites_id is set (edit_level).
edit_sprites writes
Changes sheets of a set of sprites of this account. Operations: {"op":"recolour","sheet","map":{"#rrggbb" or "transparent":"#rrggbb" or "transparent"},"region"?} (the easiest: a red Sonic, other badniks); {"op":"draw","sheet","x","y","pixels":{palette, rows, scale}} pixel art drawn at x, y (its transparent pixels erase); {"op":"reset","sheet"} back to the game's. A sheet keeps its size and layout (the game cuts the frames at the same places). All or nothing.

Tiles

get_tileset
A tileset: each block's collision shape, front, behaviour, animation (the blocks it shows in turn), and the image of all its blocks (16 a row, 32 x 32 each; scale 2 doubles it to see the pixels better).
get_tileset_block
Blocks of a tileset as pixel art text (palette + 32 rows of 32 characters), with their collision: to copy a style, change a block, or see exactly what is drawn. Up to 8 blocks at once.
create_tileset writes
A new empty tileset on this account (private): blocks empty blocks (1 by default). Draw them with edit_tileset. To start from a zone of the game or another tileset, use fork.
edit_tileset writes
Changes a tileset of this account: draws blocks (pixel art as text), copies blocks, recolours, sets collisions, behaviours and animations (water, waterfalls, lava, lights). All or nothing. Levels using it change too.

Without MCP: the REST API

The same tools, in JSON, for a script or an AI without MCP. The list (with the schema of the arguments): GET https://sonic.mimichat.fr/api/v1, or as OpenAPI: https://sonic.mimichat.fr/api/v1/openapi.json.

curl -s https://sonic.mimichat.fr/api/v1/whoami -X POST -H "Authorization: Bearer sk_sonic_..."

curl -s https://sonic.mimichat.fr/api/v1/test_level -X POST -H "Authorization: Bearer sk_sonic_..." \
     -H "Content-Type: application/json" -d '{"id": 12}'

Answer: {"ok": true, "data": {…}, "images": ["(PNG en base64)"]}, or {"ok": false, "error": "…"} (code 400).

Security