dansugc-mcp-server
v1.2.0
Published
MCP server for the DanSUGC B-Roll video API — search, browse, purchase, and manage B-roll video clips
Maintainers
Readme
DanSUGC MCP Server
MCP (Model Context Protocol) server for the DanSUGC API. Enables LLMs to search, buy, and manage B-roll video clips — and push content to connected TikTok and Instagram accounts.
Setup
1. Install dependencies
cd mcp-server
npm install
npm run build2. Get an API key
Create an API key at dansugc.com/dashboard/api-keys.
3. Configure your MCP client
Add to your Claude Desktop config (claude_desktop_config.json):
{
"mcpServers": {
"dansugc-broll": {
"command": "node",
"args": ["/absolute/path/to/mcp-server/dist/index.js"],
"env": {
"DANSUGC_API_KEY": "dsk_your_api_key_here"
}
}
}
}Or for Claude Code (.claude/settings.json):
{
"mcpServers": {
"dansugc-broll": {
"command": "node",
"args": ["/absolute/path/to/mcp-server/dist/index.js"],
"env": {
"DANSUGC_API_KEY": "dsk_your_api_key_here"
}
}
}
}Environment Variables
| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| DANSUGC_API_KEY | Yes | — | Your dsk_ prefixed API key |
| DANSUGC_API_BASE_URL | No | https://dansugc.com/api/v1 | Override the API base URL |
Available Tools
B-Roll
search_videos
Search and browse B-roll videos with full-text search, AI semantic search, and filters (emotion, gender, location, age, difficulty, virality, and more).
get_video
Get detailed information about a specific video by ID, including pricing, attributes, creator info, and preview URLs.
purchase_videos
Purchase up to 50 videos at once. Deducts credits from your platform balance. Returns full-quality download URLs and remaining balance.
list_purchases
List purchase history for billing reconciliation. Supports search, date ranges, video attribute filters, and sorting.
get_balance
View account summary including total purchases and total spend.
manage_customer_keys
Create, list, or revoke per-customer API keys (requires keys:manage scope).
Posting
check_posting_subscription
Check your posting plan, status, and social set usage.
list_social_sets
List all social sets (groups of TikTok/Instagram accounts).
create_social_set
Create a new social set. Connect accounts via the dashboard after creation.
list_posting_accounts
List all connected TikTok and Instagram accounts. Returns UUIDs needed for create_post.
create_post
Create, schedule, or immediately publish a post to one or more connected accounts. Pass B-Roll download URLs directly as media_urls.
list_posts
List posts with their status (draft, scheduled, published, failed).
get_posting_analytics
Get cross-platform analytics: followers, engagement rate, likes, and top posts.
Social Intelligence (ScrapCreators proxy, $0.02/request)
tiktok_search_videos / tiktok_user_videos / tiktok_search_users
Search TikTok content and creators.
instagram_search_reels / instagram_user_reels
Search Instagram Reels.
scrapecreators_raw
Raw passthrough to any ScrapCreators endpoint.
Example Usage
Once configured, you can ask Claude:
B-Roll:
- "Search for happy indoor reaction videos"
- "Find B-roll clips with female creators, difficulty under 5"
- "Purchase videos abc123 and def456"
- "Show my purchases from last month"
Posting:
- "List my connected social accounts"
- "Schedule this video to my TikTok and Instagram for tomorrow at 6pm ET"
- "Show all my scheduled posts"
- "What's my engagement rate over the last 30 days?"
- "Source 5 excited B-roll clips and schedule one per day this week"
