{"_id":"@blossai/mcp-server","name":"@blossai/mcp-server","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@blossai/mcp-server","version":"0.1.0","description":"Model Context Protocol server for Blossom — exposes the Blossom Public API to LLM clients (Claude Desktop, Cursor, Continue, etc.)","type":"module","main":"dist/index.js","bin":{"blossom-mcp":"dist/index.js"},"engines":{"node":">=18"},"scripts":{"build":"esbuild src/index.ts --bundle --platform=node --target=node18 --format=esm --outfile=dist/index.js --packages=external --banner:js='#!/usr/bin/env node'","start":"node dist/index.js","dev":"tsx src/index.ts","inspect":"npx -y @modelcontextprotocol/inspector node dist/index.js"},"keywords":["mcp","modelcontextprotocol","blossom","claude","viral-content"],"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","zod":"^3.23.8"},"devDependencies":{"@types/node":"^20.0.0","tsx":"^4.19.0","typescript":"^5.7.0"},"_id":"@blossai/mcp-server@0.1.0","_nodeVersion":"25.6.1","_npmVersion":"11.9.0","dist":{"integrity":"sha512-zVE+VIppXRTisvGsErj451snSV1aMFASqJ6bMXv4zO8gq2kWBJ7kR/VkdMHSZQ11kHJO+Rp+DmO0G3eq8DMNlA==","shasum":"7281402f0d982ae1ca80290b2e84c5d5b526280e","tarball":"https://registry.npmjs.org/@blossai/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":3,"unpackedSize":17294,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD5uBakLWd1VFx7K4D3sClJ4PmOENzOQT/eHIB5Ul7FYwIhANYJAIXnvDFK1/xWRtiaU3LFAtR/BgcKuNgoOosHILb2"}]},"_npmUser":{"name":"blossomaix","email":"teoman.tingir@gmail.com"},"directories":{},"maintainers":[{"name":"blossomaix","email":"teoman.tingir@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.0_1779492716161_0.32392543493347103"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-22T23:31:55.927Z","0.1.0":"2026-05-22T23:31:56.302Z","modified":"2026-05-22T23:31:56.645Z"},"maintainers":[{"name":"blossomaix","email":"teoman.tingir@gmail.com"}],"description":"Model Context Protocol server for Blossom — exposes the Blossom Public API to LLM clients (Claude Desktop, Cursor, Continue, etc.)","keywords":["mcp","modelcontextprotocol","blossom","claude","viral-content"],"license":"MIT","readme":"# @blossai/mcp-server\n\nModel Context Protocol server for [Blossom](https://blossai.com). Exposes the Blossom Public API to LLM clients (Claude Desktop, Cursor, Continue, etc.) so an AI agent can browse the viral-content library, surface trends, generate ideas, and trigger fresh analyses.\n\n## Install\n\nThe recommended path is `npx` — no global install required.\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"blossom\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@blossai/mcp-server\"],\n      \"env\": {\n        \"BLOSSOM_API_KEY\": \"blsm_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The Blossom tools appear in the tool list.\n\n### Cursor / Continue / other MCP clients\n\nUse the same JSON shape in your client's MCP config. Most clients accept a `command + args + env` triple.\n\n## Getting an API key\n\n1. Sign in to Blossom and open **Account → API Keys**.\n2. Make sure you're on an active **Pro**, **Premium**, or **Platin** plan.\n3. Click **Create key**, copy the `blsm_...` value shown once, paste it into `BLOSSOM_API_KEY` above.\n\nThe Free tier cannot create keys.\n\n## Configuration\n\n| Env var | Default | Purpose |\n|---|---|---|\n| `BLOSSOM_API_KEY` | *(required)* | API key from Account → API Keys |\n| `BLOSSOM_API_URL` | `https://api.blossai.com` | Override for self-hosted / staging |\n\n## Tools\n\nRead-only data:\n\n| Tool | Returns |\n|---|---|\n| `list_videos` / `get_video` | Analyzed videos with metrics, classifications, tactics |\n| `list_influencers` / `get_influencer` | Creator profiles |\n| `list_formats` / `get_format` | Viral format classes with aggregate metrics |\n| `list_hooks` / `get_hook` | Hook patterns (first 1-3 seconds) |\n| `list_tactics` / `get_tactic` | Specific techniques (pattern interrupts, open loops, ...) |\n| `list_music` / `get_track` | Trending audio with BPM / key / energy |\n| `list_suggestions` / `get_suggestion` | AI-generated content ideas |\n| `list_trending` | What's breaking right now |\n| `list_categories` | Categories the key can read |\n\nAnalysis:\n\n| Tool | Purpose |\n|---|---|\n| `trigger_analysis` | Submit a TikTok/Instagram URL → returns `analysis_id` immediately |\n| `get_analysis_status` | Poll the analysis (recommended cadence: 5s; finishes in ~20-45s) |\n\nAccount:\n\n| Tool | Purpose |\n|---|---|\n| `get_account_info` | Plan, rate limit, usage, remaining quota |\n\n## Rate limits\n\nPer [Blossom Public API](https://blossai.com/docs/public-api):\n\n| Plan | Rate limit |\n|---|---|\n| Pro | 30 req/min |\n| Premium | 60 req/min |\n| Platin | 100 req/min |\n\nThe MCP server surfaces 429 / 403 responses as MCP error tool-results so the LLM can react gracefully.\n\n## Local development\n\n```bash\nnpm install\nBLOSSOM_API_KEY=blsm_... npm run dev    # tsx-based hot reload\nnpm run build && npm run inspect         # MCP Inspector UI\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-a5f36424836145331ff61ebfeb35cb80"}