Allows fetching and saving PICO-8 documentation from sources like the PICO-8 Fandom wiki to be used as local MCP resources for game development and code reference.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PICO-8 MCP ServerCount the tokens in game.p8 and check for errors"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PICO-8 MCP Server
An MCP server for working with PICO-8 game carts, built on top of shrinko8.
Features
Code Analysis Tools
count_tokens - Count tokens, characters, and compressed size
analyze_cart - List functions, globals, and code metrics
validate_cart - Validate cart with token limits and linting
search_code - Search for code patterns across carts
compare_carts - Compare two cart versions with diff
Cart Manipulation
read_cart - Read cart sections (code, gfx, map, sfx, music)
minify_cart - Minify carts to reduce token count
list_carts - List all carts in a directory with metadata
Documentation Resources
add_documentation - Fetch and save PICO-8 documentation from URLs
Resources - Saved documentation is available as MCP resources (e.g.,
pico8://docs/api)
Installation
Prerequisites
Python 3.8+
uv package manager
Setup
Clone the repository:
Initialize the shrinko8 submodule:
Install dependencies:
For Claude Code (VSCode)
Add the server using the Claude CLI:
Or manually create a .mcp.json in your project root:
For Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
Usage Examples
Once configured, you can ask Claude:
"Count the tokens in my horizon-glide cart"
"Analyze the code structure of v0.16.p8"
"Search for all uses of 'terrain' in my carts"
"Compare v0.15.p8 and v0.16.p8"
"List all carts in the horizon-glide directory"
"Validate my cart and show any errors"
Adding Documentation
You can fetch and save PICO-8 documentation:
Once saved, Claude can automatically reference the documentation when helping with PICO-8 code.
License
MIT (inherits from shrinko8)