bucket-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BUCKET_API_KEY | Yes | Your Bucket API key | |
| BUCKET_API_URL | No | Bucket API URL | Bucket production API |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_bucketA | Semantic search over everything saved in the user's Bucket (reels, TikToks, tweets, links, notes). Returns matches with summaries; use get_item for full detail. |
| list_recentA | List recently saved Bucket items, optionally filtered by category (e.g. instagram, tiktok, twitter, youtube, recipes, fitness…). |
| get_itemA | Full detail for one saved item: complete transcript, summary, OCR text, visual description, locations, and original URL. |
| download_videoA | Download a saved item's video (reel/TikTok/tweet video) as an MP4 file written to the local filesystem. Returns the absolute path of the written file. |
| save_to_bucketA | Save a URL (reel, TikTok, tweet, article…) into the user's Bucket. Bucket extracts, summarizes, and categorizes it in the background. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool serves a distinct purpose: search, list recent, get detail, download video, and save. There is no overlap in actions or resources, making it easy for an agent to select the correct tool.
Most tools follow a clear verb_noun pattern (search_bucket, get_item, download_video, save_to_bucket), but 'list_recent' omits the noun and 'save_to_bucket' includes a preposition, creating a minor inconsistency. Overall, the style is still predictable and readable.
Five tools is well-scoped for a content saving and retrieval service. Each tool covers a distinct operation without unnecessary redundancy, and the count falls comfortably within the ideal range.
The set covers the main workflow (save, search, list, get detail, download) but lacks a delete operation, which is a fundamental part of managing saved content. This is a notable gap that could force agents to leave items in the bucket indefinitely.