Bool plugin

The official plugin for Bool, which builds and publishes web apps from a description. Bool is operated by CodeHS, Inc.

The plugin connects an AI assistant to Bool's hosted MCP server at https://bool.com/api/mcp and adds a skill that tells the assistant how to use Bool's tools. It runs no server of its own and holds no secrets. Users sign in with their Bool account through OAuth. The license is MIT.

Install

Client	How
ChatGPT and Codex	Search Bool in the plugin directory once it's listed.
Cursor	Customize, then Marketplace, then search Bool.
Grok Build	Settings, then Plugins, then search Bool.
Any other MCP client	Add https://bool.com/api/mcp as a remote MCP server and sign in with Bool.

Layout

One repo serves every client. The shared parts follow the Agent Plugins format, which ChatGPT, Codex, Cursor, VS Code and GitHub Copilot read directly. Each client that needs more gets a small file of its own.

Path	Read by	Holds
plugin.json	Agent Plugins clients	Name, version, publisher. The OpenAI listing, review cases and release notes live under extensions.com.openai.
mcp.json	Agent Plugins clients	The bool server, over Streamable HTTP.
skills/bool/SKILL.md	Every client	When and how to use Bool's tools.
assets/	Every client	Icon, logo and wordmark.
.cursor-plugin/plugin.json	Cursor	Display name and logo.
.claude-plugin/plugin.json, .mcp.json	Claude Code, Grok Build	The same plugin in their manifest format.
server.json	The official MCP Registry	The registry entry, com.bool/bool.

Keep the version the same in all four manifests. CI checks it.

Publish to the MCP Registry

mcp-publisher login http --domain bool.com --private-key "$(openssl pkey -in ~/.config/bool/mcp-registry-key.pem -noout -text | grep -A3 priv: | tail -n +2 | tr -d ' :\n')"
mcp-publisher publish

bool.com serves the matching public key at /.well-known/mcp-registry-auth. Bump version in server.json before republishing.

Release to the OpenAI plugin directory

scripts/build-openai-zip.sh

The script writes dist/bool-<version>.zip with only what OpenAI reads: plugin.json, mcp.json, skills/, assets/, README.md and LICENSE. Upload it from the Bool plugin's page in the OpenAI Platform with Upload plugin to make changes. The Upload new or existing plugin button on the Plugins list creates a separate plugin.

Support

• Terms
• Privacy
• MCP docs
• [email protected]