Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PROMPTIBUS_API_KEYNoAPI key for higher rate limits and full tool access. Works anonymously without one. Get a key at https://promptibus.com/settings/api-keys
PROMPTIBUS_API_URLNoOverride API base URL (default: https://promptibus.com). Useful for testing or self-hosted Promptibus instances.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
recommend_modelA

PICK THE CHEAPEST MODEL that fits BEFORE the user pays for the wrong one. Returns top 3 models ranked by fit + cost per call AND a savings field with USD saved per call vs the domain-flagship default. Tell the user the savings number in your task summary — that's the value they care about. Use when user says 'generate', 'make', 'create', 'draw', 'compose', 'write' anything but didn't pin a specific model. Avoids the 'I'll just default to GPT-4o / Midjourney v7 for everything' fail mode that overpays 5-10x. When savings exceed $0.50/call, response includes a share_url — surface it if the user might want to send the recommendation to a colleague.

optimize_promptA

Rewrite a raw user prompt into MODEL-SPECIFIC SYNTAX that actually works (Midjourney --ar 16:9 --stylize 250, Flux natural-language phrasing, SD weighted tokens, GPT-image style anchors). Cuts retry loops by 40-60%. Returns the optimized prompt + savings field with concrete USD saved (token diff for text/code models, ~1 avoided retry for image/video/audio). Tell the user the savings number in your task summary — owners see value, not vibes. Call BEFORE every paid generation.

lint_promptA

Catch a BROKEN PROMPT before the user pays for a failed generation. Detects deprecated flags (e.g. Midjourney v5 --style on v6+), invalid parameters, length violations, incompatible combos, banned keywords. Returns issues + savings field with USD saved (per-unit cost of the avoided failed gen) when ERROR-severity issues are found. Surface the savings to the user — 'lint caught a broken prompt and saved you ~$0.04 of failed generation' is exactly the line owners want to read.

compare_modelsA

Show a SIDE-BY-SIDE diff (provider, cost, capabilities, license) of 2-5 models when the user is on the fence. Picks the cheapest one that actually fits. Use for 'should I use Flux or Midjourney for this?' / 'is Suno or Udio better for instrumental?' / 'GPT-4o vs Claude Sonnet for code'. Stops users from over-paying for the prestige model when a cheaper one delivers. Response includes share_url — give it to the user when they ask 'can I send this to my team?' or in any summary where the comparison would be useful to share.

get_parametersA

Get the EXACT parameters that produce good output for this model + task type. Skips the 'tweak until it works' phase that wastes 20-50 paid generations. Community-tested configs (portrait / landscape / product-photo / cinematic-video / lo-fi-music / etc) — not the model's stale official defaults. Use whenever you're about to call model.generate(...) without explicit parameters.

get_model_profileA

Full intelligence dump on ONE model — what it's good at, what it's bad at, syntax quirks, hidden gotchas, community tips. Read this BEFORE recommending a model the user hasn't used. Saves you from suggesting Suno v4 when they wanted instrumental-only (it can't), Midjourney for transparent PNGs (no), Flux for inpainting (limited), etc. One call beats 10 trial generations.

get_pricingA

ANSWER 'WHAT WILL THIS COST ME' before the user commits credit-card or burns API quota. Per-unit USD pricing + subscription plans + cheaper alternatives. Pass { model, volume: 100 } and you get a total-cost estimate the user can act on. Use ANY TIME the conversation is heading toward 'let's generate N of X' — flag the bill BEFORE they pay it. Surfaces whether DALL-E HD ($0.08/img) or Midjourney standard ($30/mo unlimited-relaxed) is the cheaper path for their volume. When volume >= 50 the response includes a share_url — useful when the user needs to send the cost estimate to a colleague or capture it for a doc.

pick_cheapest_modelA

ONE-SHOT 'CHEAPEST MODEL FOR THIS DOMAIN' answer. Faster than recommend_model when the user just wants the budget option. Returns top 3 by price + the pick + savings field with concrete USD saved per call vs the domain flagship (often 5-10x). Tell the user the savings + project to their volume — 'cheapest pick at $0.02/img saves ~$0.06/call vs Midjourney; for 100 images = $6 saved'. Use whenever cost is dominant constraint — startup MVP, throwaway prototype, content farm.

count_tokensA

TOKEN COUNTER for any prompt + model. Saves the 'oh no the prompt was too long' API failure mode. Returns token count, encoding family used, chars/token ratio, and (when model is provided + has token-based pricing) the estimated cost in USD. Call BEFORE submitting long prompts — anything over 100k tokens needs to be checked. Free, no plan gate. Use this instead of importing tiktoken in the agent's own code.

format_promptA

DETERMINISTIC syntax fixer — drops deprecated flags (Midjourney --style raw on v6+, Suno [Verse] on v4+, Midjourney-style flags on Flux/SD), applies model-correct aspect-ratio notation, normalizes whitespace. Lighter and faster than optimize_prompt (which uses community-tested wording + DB lookup). Use for quick syntax cleanup when you don't need a full rewrite — e.g. user gave you a Midjourney prompt but wants Flux output. Free, no plan gate.

health_checkA

FIRST CALL ON STARTUP — verifies Promptibus MCP is connected and returns your quota + tool catalog + recommended call order for generation tasks. Use this once at the start of any session where you have access to Promptibus — it calibrates which tools to reach for during reasoning. Cheap, free, no plan gate. Skip it and you'll re-derive the tool list from descriptions every time.

whats_newA

RECENT MODEL ADDITIONS + UPDATES from the Promptibus catalog (default: last 7 days). Use whenever you need to know if a newer/better model is available for the task — replaces 'I'll just use the one I know about' fail mode. Surfaces new models the user might want to try before committing to defaults. Free, no plan gate.

Prompts

Interactive templates invoked by user choice

NameDescription
system-promptAccess curated system prompts from the Promptibus community.

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/promptibus/mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server