@arizeai/phoenix-mcp 4.0.0 → 4.0.2

package/README.md

@@ -112,16 +112,23 @@ Make sure to set these in a `.env` file. See `.env.example`.
 
 ## Tool Coverage
 
-The MCP server now covers the main operational Phoenix workflows:
-
-- `list-projects`, `get-project`
-- `list-traces`, `get-trace`
-- `get-spans`, `get-span-annotations`
-- `list-sessions`, `get-session`
-- `list-annotation-configs`
-- `list-datasets`, `get-dataset`, `get-dataset-examples`, `get-dataset-experiments`, `add-dataset-examples`
-- `list-experiments-for-dataset`, `get-experiment-by-id`
-- `list-prompts`, `get-prompt`, legacy prompt getter aliases, prompt version/tag tools, `upsert-prompt`
+The MCP server covers the main operational Phoenix workflows:
+
+**Prompts** — `list-prompts`, `get-prompt`, `get-latest-prompt`, `get-prompt-by-identifier`, `get-prompt-version`, `list-prompt-versions`, `get-prompt-version-by-tag`, `list-prompt-version-tags`, `add-prompt-version-tag`, `upsert-prompt`
+
+**Projects** — `list-projects`, `get-project`
+
+**Traces** — `list-traces`, `get-trace`
+
+**Spans** — `get-spans`, `get-span-annotations`
+
+**Sessions** — `list-sessions`, `get-session`
+
+**Annotation Configs** — `list-annotation-configs`
+
+**Datasets** — `list-datasets`, `get-dataset`, `get-dataset-examples`, `get-dataset-experiments`, `add-dataset-examples`
+
+**Experiments** — `list-experiments-for-dataset`, `get-experiment-by-id`
 
 For Phoenix documentation search, use the separate Phoenix Docs MCP server instead of this package.
 

package/build/constants.js

@@ -1,42 +1,21 @@
-// ============================================================
-// Pagination
-// ============================================================
 /** Default number of items fetched per API page request. */
 export const DEFAULT_PAGE_SIZE = 100;
-// ============================================================
-// Span queries
-// ============================================================
 /** Maximum number of spans that a single query may return. */
 export const MAX_SPAN_QUERY_LIMIT = 1000;
-// ============================================================
-// List queries (datasets, experiments, projects, configs)
-// ============================================================
 /** Upper bound for the `limit` parameter on list endpoints. */
 export const MAX_LIST_LIMIT = 500;
-// ============================================================
-// Annotation fetching
-// ============================================================
 /** Number of span IDs included in each annotation chunk request. */
 export const ANNOTATION_CHUNK_SIZE = 100;
 /** Maximum number of annotation chunk requests executed concurrently. */
 export const MAX_CONCURRENT_ANNOTATION_REQUESTS = 5;
 /** Page size used when exhausting annotation pages within a single chunk. */
 export const ANNOTATION_PAGE_SIZE = 1000;
-// ============================================================
-// Trace queries
-// ============================================================
 /** Default number of traces returned by the list-traces tool. */
 export const DEFAULT_TRACE_PAGE_SIZE = 10;
 /** Maximum number of traces the list-traces tool may return. */
 export const MAX_TRACE_PAGE_SIZE = 100;
-// ============================================================
-// Session queries
-// ============================================================
 /** Maximum number of sessions the list-sessions tool may return. */
 export const MAX_SESSION_PAGE_SIZE = 100;
-// ============================================================
-// Prompt defaults
-// ============================================================
 /** Default model provider when creating a prompt version. */
 export const DEFAULT_MODEL_PROVIDER = "OPENAI";
 /** Default model name when creating a prompt version. */
@@ -49,13 +28,7 @@ export const DEFAULT_TEMPERATURE = 0.7;
  * Anthropic models require an explicit `max_tokens` invocation parameter.
  */
 export const ANTHROPIC_DEFAULT_MAX_TOKENS = 1000;
-// ============================================================
-// Time
-// ============================================================
 /** Number of milliseconds in one minute. */
 export const MS_PER_MINUTE = 60_000;
-// ============================================================
-// MCP metadata
-// ============================================================
 /** Provenance tag applied to dataset examples created through the MCP server. */
 export const MCP_SYNTHETIC_SOURCE = "Synthetic Example added via MCP";

package/build/datasetUtils.js

@@ -17,7 +17,6 @@ export function isPhoenixDatasetId(identifier) {
  * datasets list endpoint.
  */
 export async function resolveDatasetId({ client, datasetId, datasetName, }) {
-    // Prefer datasetId when provided
     if (datasetId) {
         const normalizedId = requireIdentifier({
             identifier: datasetId,

package/build/sessionTools.js

@@ -1,5 +1,5 @@
 import z from "zod";
-import { DEFAULT_TRACE_PAGE_SIZE, MAX_SESSION_PAGE_SIZE } from "./constants.js";
+import { DEFAULT_TRACE_PAGE_SIZE, MAX_SESSION_PAGE_SIZE, MAX_SPAN_QUERY_LIMIT, } from "./constants.js";
 import { requireIdentifier } from "./identifiers.js";
 import { fetchAllPages } from "./pagination.js";
 import { resolveProjectIdentifier } from "./projectUtils.js";
@@ -36,7 +36,7 @@ async function fetchSessionAnnotations({ client, projectIdentifier, sessionId, }
         label: "projectIdentifier",
     });
     return fetchAllPages({
-        limit: Infinity,
+        limit: MAX_SPAN_QUERY_LIMIT,
         fetchPage: async (cursor, pageSize) => {
             const query = {
                 session_ids: [sessionId],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arizeai/phoenix-mcp",
-  "version": "4.0.0",
+  "version": "4.0.2",
   "description": "A MCP server for Arize Phoenix",
   "keywords": [
     "arize-phoenix",
@@ -28,15 +28,15 @@
     "glob": "^13.0.6",
     "minimist": "^1.2.8",
     "zod": "^4.3.6",
-    "@arizeai/phoenix-client": "6.5.3",
-    "@arizeai/phoenix-config": "0.1.2"
+    "@arizeai/phoenix-client": "6.5.5",
+    "@arizeai/phoenix-config": "0.1.3"
   },
   "devDependencies": {
     "@types/glob": "^9.0.0",
     "@types/minimist": "^1.2.5",
     "@types/node": "^22.14.0",
     "tsx": "^4.21.0",
-    "vitest": "^4.0.10"
+    "vitest": "^4.1.0"
   },
   "scripts": {
     "build": "tsc && chmod 755 build/index.js",