portkey-admin-mcp 0.3.8 → 0.4.0

package/README.md

@@ -1,22 +1,18 @@
 <div align="center">
 
-# Portkey Admin MCP Server
+<img src="./assets/portkey-balloon-spin-light.webp" alt="Portkey Admin MCP icon" width="180" height="180">
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://readme-typing-svg.demolab.com?font=Fira+Code&pause=1000&color=FFFFFF&center=true&vCenter=true&width=500&lines=150+tools+for+Portkey+Admin+API;Prompts%2C+Configs%2C+Analytics;Full+MCP+Protocol+1.0+Server">
-  <source media="(prefers-color-scheme: light)" srcset="https://readme-typing-svg.demolab.com?font=Fira+Code&pause=1000&color=000000&center=true&vCenter=true&width=500&lines=150+tools+for+Portkey+Admin+API;Prompts%2C+Configs%2C+Analytics;Full+MCP+Protocol+1.0+Server">
-  <img src="https://readme-typing-svg.demolab.com?font=Fira+Code&pause=1000&color=000000&center=true&vCenter=true&width=500&lines=150+tools+for+Portkey+Admin+API;Prompts%2C+Configs%2C+Analytics;Full+MCP+Protocol+1.0+Server" alt="Typing SVG">
-</picture>
+# Portkey Admin MCP Server
 
 MCP server for the [Portkey](https://portkey.ai/) Admin API. Manage prompts, configs, analytics, API keys, and more from any MCP client.
 
 <a href="https://www.npmjs.com/package/portkey-admin-mcp"><img src="https://img.shields.io/npm/v/portkey-admin-mcp.svg" alt="npm version"></a>
 <a href="https://www.npmjs.com/package/portkey-admin-mcp"><img src="https://img.shields.io/npm/dm/portkey-admin-mcp.svg" alt="npm downloads"></a>
 <a href="https://github.com/CodesWhat/portkey-admin-mcp/actions/workflows/ci.yml"><img src="https://github.com/CodesWhat/portkey-admin-mcp/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
-<a href="https://nodejs.org/"><img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg" alt="Node.js"></a>
+<a href="https://nodejs.org/"><img src="https://img.shields.io/badge/node-%3E%3D24-brightgreen.svg" alt="Node.js"></a>
 <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
 <a href="https://github.com/punkpeye/awesome-mcp-servers"><img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome MCP Servers"></a>
-<a href="https://lobehub.com/mcp/codeswhat-portkey-admin-mcp"><img src="https://lobehub.com/badge/mcp/codeswhat-portkey-admin-mcp?style=flat" alt="MCP Badge"></a>
+[![MCP Badge](https://lobehub.com/badge/mcp-full/codeswhat-portkey-admin-mcp?theme=light)](https://lobehub.com/mcp/codeswhat-portkey-admin-mcp)
 
 <a href="https://glama.ai/mcp/servers/CodesWhat/portkey-admin-mcp"><img src="https://glama.ai/mcp/servers/CodesWhat/portkey-admin-mcp/badges/card.svg" alt="portkey-admin-mcp MCP server"></a>
 
@@ -220,6 +216,7 @@ Key points:
 docker build -t portkey-admin-mcp .
 docker run \
   -e PORTKEY_API_KEY=your_key \
+  -e MCP_TRANSPORT=http \
   -e MCP_HOST=0.0.0.0 \
   -e MCP_PORT=3000 \
   -e MCP_AUTH_MODE=bearer \

package/build/index.js

@@ -2797,7 +2797,7 @@ function registerConfigsTools(server, service) {
   );
   server.tool(
     "update_config",
-    "Update a config by slug and create a new version. Only provided fields change; name and status are editable, while the slug stays fixed. Use list_config_versions if you need history first.",
+    "Update a config by slug and create a new version. Only provided fields change; name, status, and all routing/cache/retry settings (cache_mode, cache_max_age, retry_attempts, retry_on_status_codes, strategy_mode, targets) are editable, while the slug stays fixed. Use list_config_versions if you need history first.",
     CONFIGS_TOOL_SCHEMAS.updateConfig,
     async (params) => {
       const config = buildConfigPayload(params);
@@ -2897,7 +2897,7 @@ var GUARDRAILS_TOOL_SCHEMAS = {
   listGuardrails: {
     workspace_id: z5.string().optional().describe("Filter guardrails by workspace ID"),
     organisation_id: z5.string().optional().describe("Filter guardrails by organization ID"),
-    page_size: z5.coerce.number().min(1).max(1e3).optional().describe("Number of items per page (1-1000, default: 100)"),
+    page_size: z5.coerce.number().min(1).max(100).optional().describe("Number of items per page (1-100, default: 100)"),
     current_page: z5.coerce.number().positive().optional().describe("Page number for pagination")
   },
   getGuardrail: {
@@ -3323,7 +3323,7 @@ function registerIntegrationsTools(server, service) {
   );
   server.tool(
     "update_integration",
-    "Update an integration's name, key, or provider-specific config. Key and config changes take effect immediately and can disrupt dependent providers or live requests.",
+    "Update an integration's name, key, or provider-specific config. Key and config changes take effect immediately and can disrupt dependent providers or live requests. Model provisioning and workspace access are managed separately via update_integration_models and update_integration_workspaces.",
     INTEGRATIONS_TOOL_SCHEMAS.updateIntegration,
     async (params) => {
       const result = await service.integrations.updateIntegration(params.slug, {
@@ -6891,7 +6891,7 @@ var USERS_TOOL_SCHEMAS = {
     cost_max: z18.coerce.number().positive().optional().describe("Maximum cost in cents to filter by"),
     status_code: z18.string().optional().describe("Filter by specific HTTP status codes (comma-separated)"),
     virtual_keys: z18.string().optional().describe("Filter by specific virtual key slugs (comma-separated)"),
-    page_size: z18.coerce.number().positive().optional().describe("Number of results per page (for pagination)")
+    page_size: z18.coerce.number().positive().max(100).optional().describe("Number of results per page (max 100)")
   },
   getUser: {
     user_id: z18.string().describe("The user ID to retrieve")
@@ -7145,9 +7145,7 @@ function registerUsersTools(server, service) {
 import { z as z19 } from "zod";
 var WORKSPACES_TOOL_SCHEMAS = {
   listWorkspaces: {
-    page_size: z19.coerce.number().positive().optional().describe(
-      "Number of workspaces to return per page (default varies by endpoint)"
-    ),
+    page_size: z19.coerce.number().positive().max(100).optional().describe("Number of workspaces to return per page (max 100)"),
     current_page: z19.coerce.number().positive().optional().describe("Page number to retrieve when results are paginated")
   },
   getWorkspace: {

package/build/server.js

@@ -2811,7 +2811,7 @@ function registerConfigsTools(server, service) {
   );
   server.tool(
     "update_config",
-    "Update a config by slug and create a new version. Only provided fields change; name and status are editable, while the slug stays fixed. Use list_config_versions if you need history first.",
+    "Update a config by slug and create a new version. Only provided fields change; name, status, and all routing/cache/retry settings (cache_mode, cache_max_age, retry_attempts, retry_on_status_codes, strategy_mode, targets) are editable, while the slug stays fixed. Use list_config_versions if you need history first.",
     CONFIGS_TOOL_SCHEMAS.updateConfig,
     async (params) => {
       const config = buildConfigPayload(params);
@@ -2911,7 +2911,7 @@ var GUARDRAILS_TOOL_SCHEMAS = {
   listGuardrails: {
     workspace_id: z5.string().optional().describe("Filter guardrails by workspace ID"),
     organisation_id: z5.string().optional().describe("Filter guardrails by organization ID"),
-    page_size: z5.coerce.number().min(1).max(1e3).optional().describe("Number of items per page (1-1000, default: 100)"),
+    page_size: z5.coerce.number().min(1).max(100).optional().describe("Number of items per page (1-100, default: 100)"),
     current_page: z5.coerce.number().positive().optional().describe("Page number for pagination")
   },
   getGuardrail: {
@@ -3337,7 +3337,7 @@ function registerIntegrationsTools(server, service) {
   );
   server.tool(
     "update_integration",
-    "Update an integration's name, key, or provider-specific config. Key and config changes take effect immediately and can disrupt dependent providers or live requests.",
+    "Update an integration's name, key, or provider-specific config. Key and config changes take effect immediately and can disrupt dependent providers or live requests. Model provisioning and workspace access are managed separately via update_integration_models and update_integration_workspaces.",
     INTEGRATIONS_TOOL_SCHEMAS.updateIntegration,
     async (params) => {
       const result = await service.integrations.updateIntegration(params.slug, {
@@ -6905,7 +6905,7 @@ var USERS_TOOL_SCHEMAS = {
     cost_max: z18.coerce.number().positive().optional().describe("Maximum cost in cents to filter by"),
     status_code: z18.string().optional().describe("Filter by specific HTTP status codes (comma-separated)"),
     virtual_keys: z18.string().optional().describe("Filter by specific virtual key slugs (comma-separated)"),
-    page_size: z18.coerce.number().positive().optional().describe("Number of results per page (for pagination)")
+    page_size: z18.coerce.number().positive().max(100).optional().describe("Number of results per page (max 100)")
   },
   getUser: {
     user_id: z18.string().describe("The user ID to retrieve")
@@ -7159,9 +7159,7 @@ function registerUsersTools(server, service) {
 import { z as z19 } from "zod";
 var WORKSPACES_TOOL_SCHEMAS = {
   listWorkspaces: {
-    page_size: z19.coerce.number().positive().optional().describe(
-      "Number of workspaces to return per page (default varies by endpoint)"
-    ),
+    page_size: z19.coerce.number().positive().max(100).optional().describe("Number of workspaces to return per page (max 100)"),
     current_page: z19.coerce.number().positive().optional().describe("Page number to retrieve when results are paginated")
   },
   getWorkspace: {

package/package.json

@@ -22,11 +22,12 @@
 		"knip": "knip",
 		"ci": "npm run lint && npm run knip && npm run typecheck && npm run test && npm run build && npm run test:e2e && npm run verify:readme-tools",
 		"start:http": "node build/server.js",
+		"publish:lobehub": "npx -y @lobehub/market-cli plugin publish --dir \"$PWD\"",
 		"prepare": "[ -n \"$CI\" ] || [ -f /.dockerenv ] || [ ! -d .git ] || lefthook install",
 		"prepublishOnly": "npm run ci"
 	},
 	"engines": {
-		"node": ">=20"
+		"node": ">=24"
 	},
 	"files": [
 		"build"
@@ -42,7 +43,7 @@
 	},
 	"name": "portkey-admin-mcp",
 	"mcpName": "io.github.CodesWhat/portkey-admin-mcp",
-	"version": "0.3.8",
+	"version": "0.4.0",
 	"main": "build/index.js",
 	"keywords": [
 		"mcp",