# SupraPrompt.ai — Desktop Extension (`.mcpb`)

Connect **SupraPrompt.ai** to Claude (Cowork & Desktop) and turn rough product-marketing
briefs into precision **AI Briefings** — battle cards, positioning, launch messaging, buyer
personas, competitive intel and more — without leaving Claude.

> Requires a **paid SupraPrompt.ai plan**. The free tier is web-app only.

## Install (Cowork / Claude Desktop)

1. Create an API key at **[supraprompt.ai/mcp](https://supraprompt.ai/mcp)** (starts with `sp_live_`).
2. Download **`SupraPrompt.mcpb`** (this repo / the latest [release](../../releases)).
3. Open Claude **Settings → Extensions** and drag the `.mcpb` in (or double-click it).
4. When prompted, paste your API key. It's stored in your OS keychain — never in plain config.
5. Ask: *"Use SupraPrompt to list available content types."*

No JSON editing, no environment variables, no OAuth.

## How it works

`.mcpb` bundles only run **local stdio** servers, but the SupraPrompt MCP server is **remote
HTTPS** (`https://supraprompt.ai/api/mcp`). So this extension ships a tiny **zero-dependency
stdio→HTTPS bridge** (`server/index.mjs`): Claude launches it locally, it reads the
`SUPRAPROMPT_API_KEY` injected from the prompted `user_config`, and forwards every MCP message
to the server with an `Authorization: Bearer` header.

```
Claude (Cowork/Desktop) ──stdio──▶ server/index.mjs ──HTTPS Bearer──▶ supraprompt.ai/api/mcp
```

Tools exposed: `supraprompt_elevate`, `supraprompt_list_content_types`.

## Tools

| Tool | What it does |
|---|---|
| `supraprompt_elevate` | Turns a brief into a structured AI Briefing for the requested content type. |
| `supraprompt_list_content_types` | Lists all available SupraPrompt content types. |

## Build

```bash
npm install        # dev-only: @anthropic-ai/mcpb
npm run validate   # schema-check manifest.json
npm run pack       # produces SupraPrompt.mcpb
```

## Distribution tracks

| Client | Use |
|---|---|
| **Claude Cowork / Desktop** | this `.mcpb` (prompts for the key) |
| **Claude Code (CLI)** | the [`supraprompt-plugins`](https://github.com/jon933/supraprompt-plugins) marketplace plugin (`SUPRAPROMPT_API_KEY` env var) |

Both authenticate to the same endpoint with the same `sp_live_…` key.

## Notes

- The published `supraprompt-mcp` **npm** package is **deprecated** (it targets a stale endpoint and returns HTML). Use this `.mcpb` instead.
- Node ≥ 18 (Claude bundles a runtime; no local Node install required).

## Support

- Web app: https://supraprompt.ai
- Email: jon@supraprompt.ai

MIT © SupraPrompt.ai