Blueprint Studio MCP server

Blueprint Studio

One plugin for Blueprint Studio Styles, assets, and durable image generation. Additional brand-context tools expose published guides and official assets when enabled on the connected server. Workflow skills and agents are optional; tools can be used directly.

This is the existing blueprint-studio plugin, upgraded in place. Its historical repository name remains claude-code-asset-generator to preserve installs. The public Blueprint marketplace remains the discovery source. No second plugin or private brand snapshot is required.

Install

Claude Code:

/plugin marketplace add Blueprint-Studio-AI/claude-code-marketplace
/plugin install blueprint-studio@blueprint-studio-marketplace

For a local branch preview, start Claude Code with --plugin-dir /absolute/path/to/this/repo. Avoid adding a second standalone MCP connection if the plugin already supplies asset-generator.

Codex uses the portable package with .codex-plugin/plugin.json retained for older clients. Install the same package through the existing marketplace:

codex plugin marketplace add https://github.com/Blueprint-Studio-AI/claude-code-marketplace.git
codex plugin add blueprint-studio@blueprint-studio-marketplace

Complete the host's MCP OAuth flow when prompted. Official ChatGPT/Codex and Claude directory reviews remain separate from direct installation.

Other skill-compatible hosts can use skills/ and connect their remote MCP client to https://tools.blueprintstudio.ai/api/mcp. plugin.json and mcp.json provide the portable Agent Plugins manifest. Host transport spellings differ; compatibility manifests are intentionally retained.

Sign in through the host's MCP OAuth flow for account-wide access. Call list_brands to discover accessible organizations, then pass explicit brandId on every workspace call. Null/omitted selects personal scope, not the last-used brand. Legacy scoped credentials cannot switch workspaces. A plugin install grants no membership. If an existing connection only lists one workspace despite broader account access, renew its OAuth authorization and start a fresh client/thread. Older workspace-only grants are not silently expanded; a new API key is not the repair. Service API keys remain available for scoped automation; inference provider keys are not needed and credentials never belong in checked-in files.

Tool contract

generateasset already returns a durable jobId immediately. Use a fresh UUID requestId for each intended generation; reuse the same ID with identical arguments only for transport retries. Poll getgeneration_status in the same brandId until completed or failed. Unknown outcomes and polling timeouts never establish failed generation or refunded credits. Preserve returned asset, receipt, and Style IDs. See the MCP contract for recovery and handoff details.

These capabilities require the current Blueprint server. Check live discovery for both tools and fields when connecting to an older deployment. Reference-set Style authoring, tracked forks, and Portal-backed tasks/approvals are not bundled features. There is no internal client list, private repository access, or automatic brand-site/database sync.

Optional skills and agents

Shortened. The full README is on GitHub.