JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 336
  • Score
    100M100P100Q78725F
  • License MIT

Model intelligence for AI agents — syntax, parameters, and routing for 67+ generative AI models via Promptibus

Package Exports

  • @promptibus/mcp
  • @promptibus/mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@promptibus/mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@promptibus/mcp — model intelligence for AI agents

npm version npm downloads Smithery License: MIT MCP Powered by Promptibus LobeHub MCP Badge

Your agent thinks Midjourney still uses --v 5. It doesn't — that flag was dropped at v7. It assumes DALL-E 3 and FLUX Schnell cost the same. They differ by ~50×. It confidently writes [Verse] tags for Suno. They were removed in v4.

This MCP server fixes that. Real syntax, real prices, real recommendations for 67+ generative AI models — over the Model Context Protocol.


Works with: Claude Desktop · Claude Code · Cursor · Windsurf · Zed · Continue.dev · n8n · any stdio MCP client Domains: image · video · audio · text · code Cost to start: $0, no account, no API key

See it in action

Your agent receives a brief — "30-second cinematic video of a thunderstorm at sea." — and instead of guessing, calls a tool.

recommend_model({ task: "30s cinematic video, thunderstorm at sea", domain: "VIDEO" })
Top 3 models for: "30s cinematic video, thunderstorm at sea"

1. Runway Gen-4 (Runway)
   Domain: VIDEO | Cost: 1 credit | Version: latest
   Improved temporal consistency, camera control, up to 20-second coherent clips.
   Source: https://promptibus.com/models/runway-gen-4

2. Sora (OpenAI)
   Domain: VIDEO | Cost: 1 credit | Version: latest
   Cinematic-quality clips from text prompts.
   Source: https://promptibus.com/models/sora

3. Veo 2 (Google)
   Domain: VIDEO | Cost: 1 credit | Version: latest
   High-fidelity clips with cinematic camera control.
   Source: https://promptibus.com/models/veo-2

The agent picks one, formats the prompt with optimize_prompt, lints the result with lint_prompt, checks get_pricing for the volume budget — all before a single token of generation cost is spent.

Why use this

  • Stops hallucination. Your agent answers from a curated DB of 67+ models, not from training data that's 6 months stale.
  • Real money, real choices. get_pricing({ model: "dall-e-3", volume: 100 }) returns actual USD cost plus cheaper alternatives — agents can finally optimize for budget, not just "vibes."
  • Right model for the job. recommend_model ranks across all five domains (image / video / audio / text / code) with reasoning, not guessing.
  • Lint before you generate. lint_prompt catches deprecated flags, invalid parameters, and length violations before you burn credits.
  • Zero friction. Works anonymously without an account. npx -y @promptibus/mcp — that's the install.

Install in 30 seconds

Option A — Smithery (recommended):

Visit smithery.ai/server/@promptibus/mcp, pick your client, click install.

Option B — drop into your client's MCP config:

{
  "mcpServers": {
    "promptibus": {
      "command": "npx",
      "args": ["-y", "@promptibus/mcp"]
    }
  }
}

Option C — hosted HTTP endpoint (no install at all):

For clients that support HTTP transport:

{
  "mcpServers": {
    "promptibus": {
      "url": "https://promptibus.com/api/mcp"
    }
  }
}

Per-client paths are listed under Client configs below.

Tools

Every tool is available on every tier — including anonymous. Tiering applies to daily request limits and which models you can query against (free-tier covers 10 popular models; Pro/Studio unlocks all 67+).

Tool What it does Example
recommend_model Top 3 models for a task, with reasoning + cost. { task: "logo with embedded text", domain: "IMAGE" }
optimize_prompt Reformats a prompt for a specific model — applies model-specific syntax + community-tested wording. { text: "a cat in space", model: "midjourney-v7" }
lint_prompt Finds deprecated flags, invalid parameters, length violations. Suggests fixes. { prompt: "a cat --ar 16:9", model: "flux-2-pro" }
compare_models Side-by-side: provider, domain, cost, capabilities. 2–5 models. { models: ["flux-2-pro","midjourney-v7"], criteria: "photorealism" }
get_parameters Recommended parameters: defaults, ranges, community configs. { model: "stable-diffusion-3-5", task_type: "portrait" }
get_model_profile Full profile: capabilities, syntax guide, parameters, community tips, related prompts. { model: "suno-v4" }
get_pricing Real USD pricing for a model / domain / planned volume. Includes cheaper alternatives. { model: "dall-e-3", volume: 100 }

Use cases

"Which video model gives me the longest single shot under $10?"get_pricing({ domain: "VIDEO", volume: 60 }) returns a sorted matrix; agent picks the cheapest that meets duration.

"Convert this DALL-E prompt to Midjourney v7 syntax."optimize_prompt({ text: "...", model: "midjourney-v7" }) reformats — proper aspect-ratio flag, no --v, model-specific suffixes applied.

"Will this Suno prompt work with v4?"lint_prompt({ prompt: "[Verse] ...", model: "suno-v4" }) flags [Verse] as deprecated and proposes the v4 structure.

"I need to generate 1000 images at the cheapest viable quality."recommend_model filters by domain + budget; get_pricing validates total cost; agent ships under budget.

Resources

Browsable model profiles as MCP resources:

promptibus://models/{slug}

Each resource returns a Markdown profile (provider, domain, version, pricing, full guide). Useful for agents that want to surface model info as a sidebar.

Prompts

The system-prompt MCP prompt exposes curated system prompts from the Promptibus community.

system-prompt                                         # lists all available
system-prompt { "slug": "midjourney-prompt-architect" } # returns full text

Plans & rate limits

Anonymous users get full tool access — no account needed. Limits + model coverage scale with plan.

Plan Daily requests Model coverage
Anonymous (no key) 25 10 free-tier models
Free (with key) 100 10 free-tier models
Pro 500 All 67+ models
Studio 2,000 All 67+ models

Limits reset daily at midnight UTC. Plans + signup at promptibus.com/pricing.

Authentication

Set PROMPTIBUS_API_KEY in your client config:

{
  "mcpServers": {
    "promptibus": {
      "command": "npx",
      "args": ["-y", "@promptibus/mcp"],
      "env": { "PROMPTIBUS_API_KEY": "psy_your_api_key_here" }
    }
  }
}
Variable Required Purpose
PROMPTIBUS_API_KEY No Higher rate limits, full model coverage. Get one at promptibus.com/settings/api-keys.
PROMPTIBUS_API_URL No Override the API base (default https://promptibus.com). For self-hosted Promptibus or staging.

FAQ

Does this generate images, video, or audio? No. It tells your agent how to use whatever generation API the agent already has access to. Think of it as a prompt engineering co-pilot, not a router.

Do I need an account to start? No. Anonymous mode works out of the box (25 req/day, free-tier models). API key raises limits and unlocks all 67+ models.

Are my prompts logged? Tool requests transit promptibus.com over HTTPS. We don't persist prompt bodies. API keys are SHA-256 hashed server-side; the raw key never lands in logs.

How fresh is the model data? Community-curated. New models typically appear within days of release; pricing is reviewed monthly. The data lives in a Postgres-backed catalogue at promptibus.com/models.

Does it work offline? The MCP server runs locally; the catalogue lives at promptibus.com. So: agent ↔ MCP server is local stdio, MCP server ↔ Promptibus is HTTPS. No internet, no answers.

Can I self-host the catalogue? Yes. The Promptibus app is open-source — clone promptibus/promptibus, point PROMPTIBUS_API_URL at your deployment.

Is there an HTTP transport instead of stdio? Yes — point your client at https://promptibus.com/api/mcp. Useful for sandboxed environments, browser-based MCP clients, and CI.

Caching

The client caches responses for tools whose output rarely changes (get_model_profile, get_parameters, compare_models, get_pricing). TTL: 24 h, in-memory per process. Cache is bypassed for tools whose output is input-dependent (recommend_model, optimize_prompt, lint_prompt).

Privacy

  • HTTPS to promptibus.com; no third-party trackers in the request path
  • API keys hashed server-side (SHA-256)
  • Anonymous usage rate-limited by IP
  • No client-side database, no local state beyond a single HTTP client

Client configs

The same npx -y @promptibus/mcp command works for every stdio client. Only the config file location and JSON shape differ.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "promptibus": {
      "command": "npx",
      "args": ["-y", "@promptibus/mcp"]
    }
  }
}
Claude Code
claude mcp add promptibus -- npx -y @promptibus/mcp
Cursor

.cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "promptibus": {
      "command": "npx",
      "args": ["-y", "@promptibus/mcp"]
    }
  }
}
Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "promptibus": {
      "command": "npx",
      "args": ["-y", "@promptibus/mcp"]
    }
  }
}
Zed

settings.json:

{
  "context_servers": {
    "promptibus": {
      "command": {
        "path": "npx",
        "args": ["-y", "@promptibus/mcp"]
      }
    }
  }
}
Continue.dev

~/.continue/config.json, under experimental.modelContextProtocolServers:

{
  "transport": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "@promptibus/mcp"]
  }
}
n8n

In the MCP Client node, set transport to stdio:

Command:   npx
Arguments: -y @promptibus/mcp

Supported models

67+ models across 5 domains. Highlights:

  • IMAGE — Midjourney v7 / v6.1 · FLUX 2 Pro / 1.1 Pro · Stable Diffusion 3.5 · DALL-E 3 · GPT Image 1 · Ideogram 3 · Recraft V4 Pro · Imagen 4 Ultra · Leonardo Phoenix
  • VIDEO — Sora · Runway Gen-3 / Gen-4 · Kling 2.5 · Pika 3 · Luma Dream Machine · Hailuo · Seedance 2 · Veo 2 · LTX 2.3 · Helios
  • AUDIO — Suno v4 / v5 · Udio 2 · ElevenLabs · Hume AI · Stable Audio 2 · MusicGen · ACE-Step
  • TEXT — GPT-5 / 5.4 · Claude 4 Opus / Sonnet · Claude Sonnet 4.6 · Gemini 3.1 Pro / 2.5 Pro · DeepSeek R2 · Llama 4 Maverick · Grok 3
  • CODE — Claude Code · Cursor · Windsurf · Codex CLI · Devin · Augment Code · Aider · Copilot · DeepSeek V3 · Nemotron 3 Super

Full catalogue: promptibus.com/models.

⭐ Help others find this

If @promptibus/mcp saves your agent from a wrong-syntax run or a $50 surprise on DALL-E volume, drop a star on the repo. Stars are how new MCP users discover quality servers in a sea of generic wrappers — it costs you a click and the next person ships faster.

Star this repo

License

MIT — © Promptibus