{"_id":"@bragfast/mcp-server","_rev":"7-408ab518190eb1e9ade620d841ea9f36","name":"@bragfast/mcp-server","dist-tags":{"latest":"0.3.4"},"versions":{"0.1.0":{"name":"@bragfast/mcp-server","version":"0.1.0","keywords":["mcp","bragfast","release","images","video"],"license":"MIT","_id":"@bragfast/mcp-server@0.1.0","maintainers":[{"name":"rob-vb","email":"hi@robvb.com"}],"homepage":"https://github.com/rob-vb/bragfast-mcp#readme","bugs":{"url":"https://github.com/rob-vb/bragfast-mcp/issues"},"bin":{"bragfast-mcp":"dist/cli.js"},"dist":{"shasum":"10dc0175222224199f5c852268cf1098a1af87a8","tarball":"https://registry.npmjs.org/@bragfast/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":38,"integrity":"sha512-0zc1BnDHnpy0VHcGLVDWG6SCL5R9SmYhD/FHuWRhe1KJFT+u3kue3qbVcY1nX2PdDuKxNXoYs15aQE1OlKYaUg==","signatures":[{"sig":"MEQCIBt5A4doDcqijs2bbHjZiur50Fx2whmyF/5KJNckza8LAiBQJG4JbOLabgDV+o6TsHFqRNkehOHdIKwgywbhW4h5Mg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bragfast%2fmcp-server@0.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":36488},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"fbc5b73e96ab2d61feceb8aa287e1c55f69a31d5","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"rob-vb","email":"hi@robvb.com"},"repository":{"url":"git+https://github.com/rob-vb/bragfast-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for Bragfast — generate release images and videos from Claude","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^4.0.0","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1774414752520_0.38479859951454576","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@bragfast/mcp-server","version":"0.1.1","keywords":["mcp","bragfast","release","images","video"],"license":"MIT","_id":"@bragfast/mcp-server@0.1.1","maintainers":[{"name":"rob-vb","email":"hi@robvb.com"}],"homepage":"https://github.com/rob-vb/bragfast-mcp#readme","bugs":{"url":"https://github.com/rob-vb/bragfast-mcp/issues"},"bin":{"bragfast-mcp":"dist/cli.js"},"dist":{"shasum":"19b04b200f233930ac49a1b9ddbdc05bda007fc4","tarball":"https://registry.npmjs.org/@bragfast/mcp-server/-/mcp-server-0.1.1.tgz","fileCount":39,"integrity":"sha512-1oHyxqPd3OKHE1SRbXZZ3ltp5brncw4gcUE/C3QQnFTzptBgLslJrx8UNYj+p9SDKIprzyd8JdIRcejQATVNTw==","signatures":[{"sig":"MEQCIGAqBngB7u0H5KKhkrEvaQhkUo7pudh/wBCL7eQcyi3SAiANxU7GoSxdvWFZAClG2l1ZnGSIvzd0B6yblzUrNaf2pw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bragfast%2fmcp-server@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":38741},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"15d337b10c2f0eaf4646204a9beba3260959fc4d","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"rob-vb","email":"hi@robvb.com"},"repository":{"url":"git+https://github.com/rob-vb/bragfast-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for Bragfast — generate release images and videos from Claude","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^4.0.0","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.1_1774415806398_0.9489024649935409","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@bragfast/mcp-server","version":"0.2.0","keywords":["mcp","bragfast","release","images","video"],"license":"MIT","_id":"@bragfast/mcp-server@0.2.0","maintainers":[{"name":"rob-vb","email":"hi@robvb.com"}],"homepage":"https://github.com/rob-vb/bragfast-mcp#readme","bugs":{"url":"https://github.com/rob-vb/bragfast-mcp/issues"},"bin":{"bragfast-mcp":"dist/cli.js"},"dist":{"shasum":"42b666e689921d6a72c237bec34b14746a3faea5","tarball":"https://registry.npmjs.org/@bragfast/mcp-server/-/mcp-server-0.2.0.tgz","fileCount":39,"integrity":"sha512-mWttuG++vt1tjEjauwOj19gy1GFyvp4J1R/RxPvPqOGJTUvFS/F+Al28aievvJ37OnTweVfbhPr91YqamDz8Fw==","signatures":[{"sig":"MEUCIBjryPfgHzLsSDpk+tfNr0JlKIRNBlYL8Kk/dGZsouolAiEA4mU56tk3e41tzqUF0hOadpUdQ60gmHFZdtzV9COXc4E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@bragfast%2fmcp-server@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":41716},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"ee175253673463710107bc638cf1f398f6761ab2","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"rob-vb","email":"hi@robvb.com"},"repository":{"url":"git+https://github.com/rob-vb/bragfast-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for Bragfast — generate release images and videos from Claude","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^4.0.0","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.2.0_1774416218966_0.07328841751281323","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@bragfast/mcp-server","version":"0.3.0","keywords":["mcp","bragfast","release","images","video"],"license":"MIT","_id":"@bragfast/mcp-server@0.3.0","maintainers":[{"name":"rob-vb","email":"hi@robvb.com"}],"homepage":"https://github.com/rob-vb/bragfast-mcp#readme","bugs":{"url":"https://github.com/rob-vb/bragfast-mcp/issues"},"bin":{"bragfast-mcp":"dist/cli.js"},"dist":{"shasum":"a285ed957aad1bb244285c9027a0fc61593a8856","tarball":"https://registry.npmjs.org/@bragfast/mcp-server/-/mcp-server-0.3.0.tgz","fileCount":42,"integrity":"sha512-MNL/jVM5RI6fJ+6o8Zp0WdSmT0eu9oGSQ1pLHE5pgCPMZ82BLhCLudwIxEREBmrxYxIJv48F/lmC9SV1CqBB/Q==","signatures":[{"sig":"MEYCIQD7o63QymWIHx0A60MwSuTrRDocK895XrQVGt/3RC9FeQIhAOa/FB2XApPzIheHcq6r0o/VV4CDzRZwFXPGdxJFOgQ2","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46481},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"b3bc81ed75daa73679d6276720281b4a23a639d8","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"rob-vb","email":"hi@robvb.com"},"repository":{"url":"git+https://github.com/rob-vb/bragfast-mcp.git","type":"git"},"_npmVersion":"11.10.1","description":"MCP server for Bragfast — generate release images and videos from Claude","directories":{},"_nodeVersion":"22.20.0","dependencies":{"zod":"^4.0.0","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.3.0_1774433114142_0.6199212748790048","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@bragfast/mcp-server","version":"0.3.1","keywords":["mcp","bragfast","release","images","video"],"license":"MIT","_id":"@bragfast/mcp-server@0.3.1","maintainers":[{"name":"rob-vb","email":"hi@robvb.com"}],"homepage":"https://github.com/rob-vb/bragfast-mcp#readme","bugs":{"url":"https://github.com/rob-vb/bragfast-mcp/issues"},"bin":{"bragfast-mcp":"dist/cli.js"},"dist":{"shasum":"386665acbbaa6a9c4ae9b5deafff64986ec73fba","tarball":"https://registry.npmjs.org/@bragfast/mcp-server/-/mcp-server-0.3.1.tgz","fileCount":42,"integrity":"sha512-RqjCIU0HsNrgtBCsNFKUsZRX4O7MvW7Kqdja6fLWL75D2/c3KGcDQjtrRU6EBifrDjfi9ylUJQTi34n0Xl1GXg==","signatures":[{"sig":"MEQCIEaWq/5+MRlvjc8SY8akWINjqBptVXAbEZOBdxxnkHmAAiAOm0nkKTJ5SrHlKh/6KpjIdg7vTiiy3j41NMgsN7fYMA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":47019},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"fdfc6bbb3af94c41fddfd8fc67dec518ba034cc5","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"rob-vb","email":"hi@robvb.com"},"repository":{"url":"git+https://github.com/rob-vb/bragfast-mcp.git","type":"git"},"_npmVersion":"11.10.1","description":"MCP server for Bragfast — generate release images and videos from Claude","directories":{},"_nodeVersion":"22.20.0","dependencies":{"zod":"^4.0.0","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.3.1_1775109945493_0.7120171509097872","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"@bragfast/mcp-server","version":"0.3.2","keywords":["mcp","bragfast","release","images","video"],"license":"MIT","_id":"@bragfast/mcp-server@0.3.2","maintainers":[{"name":"rob-vb","email":"hi@robvb.com"}],"homepage":"https://github.com/rob-vb/bragfast-mcp#readme","bugs":{"url":"https://github.com/rob-vb/bragfast-mcp/issues"},"bin":{"bragfast-mcp":"dist/cli.js"},"dist":{"shasum":"03ea2cafaee54374a1616027d310e7fd66690175","tarball":"https://registry.npmjs.org/@bragfast/mcp-server/-/mcp-server-0.3.2.tgz","fileCount":42,"integrity":"sha512-9ldOdJcvnvSyR2f2JVcnLzMlz8nqMyp4r2bCecKOqm3EvIsAV4g+lH4Btc0XOVlf+BQMBP+/lIqAAdFjQa/Y0Q==","signatures":[{"sig":"MEUCIAnIzR84AtSqWYkra/Ll0lQQglApx6hMWZtk9SJ1MP02AiEAgZc9As2N+X/cQ4gq0kxuqbNtaZVSGKpgOaKgheOKqZ0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":47019},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"4ae6f64f6a2d95423475966f39bee83dd0e5b339","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"rob-vb","email":"hi@robvb.com"},"repository":{"url":"git+https://github.com/rob-vb/bragfast-mcp.git","type":"git"},"_npmVersion":"11.10.1","description":"MCP server for Bragfast — generate release images and videos from Claude","directories":{},"_nodeVersion":"22.20.0","dependencies":{"zod":"^4.0.0","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.3.2_1775113555727_0.6181884966784779","host":"s3://npm-registry-packages-npm-production"}},"0.3.4":{"name":"@bragfast/mcp-server","version":"0.3.4","description":"MCP server for Bragfast — generate release images and videos from Claude","type":"module","main":"dist/index.js","bin":{"bragfast-mcp":"dist/cli.js"},"scripts":{"build":"tsc","dev":"tsc --watch","serve":"node dist/serve.js","test":"vitest run","test:watch":"vitest","prepublishOnly":"npm run build"},"engines":{"node":">=18"},"keywords":["mcp","bragfast","release","images","video"],"repository":{"type":"git","url":"git+https://github.com/rob-vb/bragfast-mcp.git"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","express":"^5.2.1","zod":"^4.0.0"},"devDependencies":{"@types/express":"^5.0.6","@types/node":"^22.0.0","typescript":"^5.7.0","vitest":"^3.0.0"},"gitHead":"dbf9f45b2de43e7bab909abf3e6310cd190dcf51","types":"./dist/index.d.ts","_id":"@bragfast/mcp-server@0.3.4","bugs":{"url":"https://github.com/rob-vb/bragfast-mcp/issues"},"homepage":"https://github.com/rob-vb/bragfast-mcp#readme","_nodeVersion":"22.20.0","_npmVersion":"11.10.1","dist":{"integrity":"sha512-WxBmf2y4Izf9bNpbcsICyYYYVbk+BrnRHEACb8Xo5qQibnGd1sRp6fXB6hSvlybgde9lQeUafNeUOLuoKE6aWQ==","shasum":"5daeab1b6eec4a51ef43721de1361cbd16067c5f","tarball":"https://registry.npmjs.org/@bragfast/mcp-server/-/mcp-server-0.3.4.tgz","fileCount":72,"unpackedSize":161337,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFEXca4h5q5C+ydkwbqvAg1jR4VHYj+5Ch9ZsoyiRgp0AiAWVJm1Hy9BYvQA0xFkUU3X2quxLFeu7JnhO+eL094Kcw=="}]},"_npmUser":{"name":"rob-vb","email":"hi@robvb.com"},"directories":{},"maintainers":[{"name":"rob-vb","email":"hi@robvb.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.3.4_1779962196593_0.12547769344429494"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-25T04:59:12.387Z","modified":"2026-05-28T09:56:36.860Z","0.1.0":"2026-03-25T04:59:12.661Z","0.1.1":"2026-03-25T05:16:46.525Z","0.2.0":"2026-03-25T05:23:39.106Z","0.3.0":"2026-03-25T10:05:14.320Z","0.3.1":"2026-04-02T06:05:45.654Z","0.3.2":"2026-04-02T07:05:55.878Z","0.3.4":"2026-05-28T09:56:36.739Z"},"bugs":{"url":"https://github.com/rob-vb/bragfast-mcp/issues"},"license":"MIT","homepage":"https://github.com/rob-vb/bragfast-mcp#readme","keywords":["mcp","bragfast","release","images","video"],"repository":{"type":"git","url":"git+https://github.com/rob-vb/bragfast-mcp.git"},"description":"MCP server for Bragfast — generate release images and videos from Claude","maintainers":[{"name":"rob-vb","email":"hi@robvb.com"}],"readme":"# @bragfast/mcp-server\n\nMCP server for [Bragfast](https://brag.fast) — generate branded release announcement images and videos from Claude.\n\n## Quick Start\n\n### Claude Desktop / Claude.ai / Cowork\n\n1. Open the app and go to **Settings → Connectors → Add Custom Connector**\n2. Paste this URL:\n\n```\nhttps://mcp.brag.fast/mcp\n```\n\n3. Sign in with your Bragfast API key when prompted.\n\n### Claude Code\n\n```bash\nclaude mcp add bragfast --transport http https://mcp.brag.fast/mcp\n```\n\n---\n\n## Alternative: Local Installation\n\nIf you prefer to run the MCP server locally (required for `bragfast_upload_image` with local file paths):\n\n### Claude Code\n\n```bash\nclaude mcp add bragfast -- npx -y @bragfast/mcp-server@latest\n```\n\n### Claude Desktop\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"bragfast\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bragfast/mcp-server@latest\"],\n      \"env\": {\n        \"BRAGFAST_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Authentication (local mode)\n\nGet an API key at [brag.fast/dashboard/account](https://brag.fast/dashboard/account), then run:\n\n```bash\nnpx @bragfast/mcp-server login <your-api-key>\n```\n\nOr set the `BRAGFAST_API_KEY` environment variable.\n\n---\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `bragfast_generate_release_images` | Generate branded release images. Returns a `cook_id` to poll. |\n| `bragfast_generate_release_video` | Generate a branded release video. Returns a `cook_id` to poll. |\n| `bragfast_list_brands` | List your brands (colors, logos, fonts). |\n| `bragfast_list_templates` | List available templates. |\n| `bragfast_get_template` | Get full template config with object IDs. |\n| `bragfast_check_account` | Check credits remaining and plan. |\n| `bragfast_upload_image` | Upload an image for use in slides. Returns a hosted URL. In remote mode, accepts base64-encoded image data (e.g. a pasted screenshot). In local mode, accepts a file path. |\n| `bragfast_get_render_status` | Poll a `cook_id` for completion. Returns image/video URLs when done. |\n\n## Example\n\n```\nYou: Generate release images for my app v2.3.0 with the new dashboard feature\n\nClaude: [calls bragfast_list_brands → picks your brand]\n        [calls bragfast_list_templates → picks standard-browser]\n        [calls bragfast_generate_release_images → gets cook_id]\n        [calls bragfast_get_render_status → returns image URLs]\n\nHere are your release images:\n- Landscape: https://brag.fast/...\n- Square: https://brag.fast/...\n```\n\n## Self-Hosting\n\nTo run the HTTP server on your own infrastructure:\n\n```bash\ngit clone https://github.com/rob-vb/bragfast-mcp.git\ncd bragfast-mcp\nnpm ci\nnpm run build\ncp .env.example .env\n# Edit .env with your BASE_URL, etc.\nnpm run serve\n```\n\nEnvironment variables:\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `PORT` | `3000` | Port to listen on |\n| `BASE_URL` | `http://localhost:3000` | Public URL (used in OAuth metadata) |\n| `BRAGFAST_API_URL` | `https://brag.fast/api/v1` | Bragfast API base URL |\n| `OAUTH_CLIENTS_FILE` | `./data/clients.json` | Path to persist OAuth clients |\n\nUse nginx or Caddy as a reverse proxy for HTTPS. Manage the process with `pm2` or `systemd`.\n\n## Development\n\n```bash\ngit clone https://github.com/rob-vb/bragfast-mcp.git\ncd bragfast-mcp\nnpm install\nnpm test        # 37 tests\nnpm run build   # compile to dist/\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}