@mafdet/mcp 0.1.3 → 0.1.5

package/README.md

@@ -8,11 +8,24 @@ It does **not** run model inference — you keep calling Mafdet AI models throug
 each tool's normal OpenAI-compatible endpoint. This server only exposes
 read-only account and documentation helpers.
 
+## What Mafdet AI is
+
+Mafdet AI is an OpenAI-compatible AI gateway: one API key and one base URL reach
+models from several providers, billed by usage. Any tool or SDK that speaks the
+OpenAI API works by pointing its base URL and key at Mafdet AI.
+
+- Base URL: `https://api.mafdet.ai/v1`
+- Endpoints: `/chat/completions`, `/embeddings`, `/audio/speech`
+- Providers: Google (Gemini), Kimi (Moonshot), Qwen, DeepSeek
+- 30 models as of August 2026. The catalogue changes, so the authoritative list
+  with current prices is [`models.json`](https://docs.mafdet.ai/models.json)
+- Docs: <https://docs.mafdet.ai>
+
 ## Tools
 
 | Tool | Needs a key | What it does |
 | --- | --- | --- |
-| `list_models` | no | List Mafdet AI models with provider, tier, and per-1M-token pricing |
+| `list_models` | no | List Mafdet AI models with provider, tier, per-1M-token pricing, and a `[preview]` / `[beta]` marker for models the provider has not declared generally available |
 | `search_docs` | no | Search the Mafdet AI documentation (titles, URLs, summaries) |
 | `get_balance` | yes | Your organization's wallet: balance, bonus, frozen, available |
 | `get_usage_summary` | yes | Requests, tokens, and charge over the last N days (1–90) |

package/dist/tools.js

@@ -53,6 +53,14 @@ export async function listModels(config, args = {}) {
             display_name: m.displayName,
             provider: m.provider,
             tier: m.accessTier,
+            // GEMMOD-003: endpoint + content modalities (additive; defaults when absent).
+            api_surface: m.apiSurface ?? "CHAT_COMPLETIONS",
+            input_modalities: Array.isArray(m.inputModalities)
+                ? m.inputModalities
+                : ["TEXT"],
+            output_modalities: Array.isArray(m.outputModalities)
+                ? m.outputModalities
+                : ["TEXT"],
             input_per_1m_micro_usd: String(m.inputPricePer1mMicroUsd ?? "0"),
             output_per_1m_micro_usd: String(m.outputPricePer1mMicroUsd ?? "0"),
             context_length: m.contextLength,
@@ -62,9 +70,18 @@ export async function listModels(config, args = {}) {
         if (models.length === 0) {
             return ok("No models matched the filter.");
         }
-        const lines = models.map((m) => `- ${m.model_id} (${m.provider}, ${m.tier})` +
-            `${m.trial ? " [trial]" : ""}${m.deprecated ? " [deprecated]" : ""}` +
-            ` — in ${money(m.input_per_1m_micro_usd)}/1M, out ${money(m.output_per_1m_micro_usd)}/1M, ctx ${m.context_length}`);
+        const lines = models.map((m) => {
+            // The catalogue marks non-GA models in the display name, and the docs
+            // site derives its badge from the same string. Without this the rendered
+            // line shows only model_id, so an agent reading this list cannot tell a
+            // preview model from a GA one.
+            const stage = /\((preview|beta)\)/i.exec(String(m.display_name ?? ""));
+            return (`- ${m.model_id} (${m.provider}, ${m.tier})` +
+                `${stage ? ` [${stage[1].toLowerCase()}]` : ""}` +
+                `${m.trial ? " [trial]" : ""}${m.deprecated ? " [deprecated]" : ""}` +
+                `${m.output_modalities.includes("IMAGE") ? " [image-out]" : ""}` +
+                ` — in ${money(m.input_per_1m_micro_usd)}/1M, out ${money(m.output_per_1m_micro_usd)}/1M, ctx ${m.context_length}`);
+        });
         return ok(`Mafdet AI models (${models.length}):\n${lines.join("\n")}`);
     }
     catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mafdet/mcp",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Mafdet AI MCP server — read-only account tools (models, balance, usage, subscription, docs) for Claude Code, Cursor, Codex, OpenCode, and Claude Desktop.",
   "type": "module",
   "license": "MIT",