Bool MCP server
Commit Oct 27, 2026Build, edit, and publish web applications directly from a conversation using an AI assistant.
Also known as codehs/bool-plugin, bool-plugin
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.1
- Last commit
- Oct 27, 2026
- License
- MIT
What is Bool MCP?
Bool is an MCP server. Build, edit, and publish web applications directly from a conversation using an AI assistant.
Summary generated from the project's README
About Bool MCP server
Building and publishing web applications through natural language conversations is the primary function of this tool. It connects AI assistants to the Bool hosted MCP server to enable the creation and editing of web apps based on simple descriptions. Developers can use this integration within clients like ChatGPT, Cursor, Grok Build, or any other MCP-compatible interface by connecting to the remote endpoint.
Users interact with the service by signing in through their existing Bool account using OAuth. Because it functions as a remote MCP server, it does not run a local server or store any secrets on your machine. The integration works across various platforms by utilizing a shared repository that follows the Agent Plugins format, ensuring compatibility with tools like VS Code and GitHub Copilot.
What you can do with it
- 1Generate web applicationsAsk your AI assistant to build a new web application based on a written description.
Written from the project's README. Every use case is checked against a quote from it.
How to install Bool MCP
Formats verified 10 Nov 2026Install Bool MCP in Claude Code
$ claude mcp add --transport http bool-plugin https://bool.com/api/mcpInstall Bool MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"bool-plugin": {
"url": "https://bool.com/api/mcp"
}
}
}Install Bool MCP in VS Code
.vscode/mcp.json
{
"servers": {
"bool-plugin": {
"type": "http",
"url": "https://bool.com/api/mcp"
}
}
}Install Bool MCP in Codex
~/.codex/config.toml
[mcp_servers.bool-plugin] url = "https://bool.com/api/mcp"
Install Bool MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"bool-plugin": {
"httpUrl": "https://bool.com/api/mcp"
}
}
}README
View on GitHubBool 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
Bool MCP questions
How do I add Bool MCP to Claude Code?
Run claude mcp add --transport http bool-plugin https://bool.com/api/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Bool MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I install the Bool plugin in ChatGPT or Codex?
You can search for Bool in the plugin directory once it is listed.
Does the Bool plugin store my secrets?
No, the plugin runs no server of its own and holds no secrets.