@greenflags/mcp 0.2.0 → 0.2.1

package/dist/index.js

@@ -23,7 +23,7 @@ const tools = [
     setFlagValue,
     archiveFlag,
 ];
-const server = new Server({ name: "greenflags", version: "0.2.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "greenflags", version: "0.2.1" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: tools.map((t) => t.toolDefinition),
 }));

package/dist/resolvers.d.ts

@@ -12,6 +12,12 @@ export interface EnvironmentRecord {
     slug: string;
     is_sensitive?: boolean;
 }
+export interface ProjectRecord {
+    id: string;
+    name: string;
+    slug: string;
+}
+export declare function resolveProjectId(projectOrSlug: string): Promise<string>;
 export declare function resolveFlagId(projectId: string, flagOrKey: string): Promise<string>;
 export declare function resolveFlag(projectId: string, flagOrKey: string): Promise<FlagRecord>;
 export declare function resolveEnvironmentId(projectId: string, envOrSlug: string): Promise<string>;
@@ -20,3 +26,4 @@ export declare function listAllFlags(projectId: string): Promise<FlagRecord[]>;
 export declare function listAllEnvironments(projectId: string): Promise<EnvironmentRecord[]>;
 export declare function invalidateFlagCache(projectId: string): void;
 export declare function invalidateEnvironmentCache(projectId: string): void;
+export declare function invalidateProjectCache(): void;

package/dist/resolvers.js

@@ -3,6 +3,9 @@ import { ApiError } from "./errors.js";
 const TTL_MS = 60_000;
 const flagCache = new Map();
 const envCache = new Map();
+// Projects are workspace-level (not scoped by a parent id), so there's a
+// single cache entry rather than one per key like flags/environments.
+let projectCache;
 function fresh(entry) {
     if (!entry)
         return undefined;
@@ -44,6 +47,26 @@ async function loadEnvironments(projectId) {
     envCache.set(projectId, entry);
     return entry;
 }
+async function loadProjects() {
+    const data = await callApi("/admin/projects");
+    const byId = new Map();
+    const byAlt = new Map();
+    for (const p of data.projects) {
+        byId.set(p.id, p);
+        byAlt.set(p.slug, p);
+    }
+    projectCache = { at: Date.now(), byId, byAlt };
+    return projectCache;
+}
+export async function resolveProjectId(projectOrSlug) {
+    const entry = fresh(projectCache) ?? (await loadProjects());
+    if (entry.byId.has(projectOrSlug))
+        return projectOrSlug;
+    const hit = entry.byAlt.get(projectOrSlug);
+    if (hit)
+        return hit.id;
+    throw new ApiError("PROJECT_NOT_FOUND", `Project '${projectOrSlug}' not found in this workspace. Use list_projects to see available projects.`, 404);
+}
 export async function resolveFlagId(projectId, flagOrKey) {
     const entry = fresh(flagCache.get(projectId)) ?? (await loadFlags(projectId));
     if (entry.byId.has(flagOrKey))
@@ -90,3 +113,6 @@ export function invalidateFlagCache(projectId) {
 export function invalidateEnvironmentCache(projectId) {
     envCache.delete(projectId);
 }
+export function invalidateProjectCache() {
+    projectCache = undefined;
+}

package/dist/tools/archiveFlag.js

@@ -1,7 +1,7 @@
 import { callApi } from "../api.js";
 import { requireProjectId } from "../config.js";
 import { okResult } from "../result.js";
-import { invalidateFlagCache, resolveFlag } from "../resolvers.js";
+import { invalidateFlagCache, resolveFlag, resolveProjectId } from "../resolvers.js";
 export const toolDefinition = {
     name: "archive_flag",
     description: "Archive a flag (soft-delete: stops being served but kept for history).\n" +
@@ -30,7 +30,7 @@ export const toolDefinition = {
     },
 };
 export async function handler(args) {
-    const projectId = requireProjectId(args["project"] ?? args["project_id"]);
+    const projectId = await resolveProjectId(requireProjectId(args["project"] ?? args["project_id"]));
     const flagArg = (args["flag"] ?? args["flag_id"]);
     if (typeof flagArg !== "string" || flagArg.trim() === "") {
         throw new Error("`flag` (key or id) is required.");

package/dist/tools/createFlag.js

@@ -1,7 +1,7 @@
 import { callApi } from "../api.js";
 import { requireProjectId } from "../config.js";
 import { okResult } from "../result.js";
-import { invalidateFlagCache } from "../resolvers.js";
+import { invalidateFlagCache, resolveProjectId } from "../resolvers.js";
 export const toolDefinition = {
     name: "create_flag",
     description: "Create a new feature flag in a project. Defaults to a boolean flag; pass `type` for string/number/json.\n" +
@@ -37,7 +37,7 @@ export const toolDefinition = {
     },
 };
 export async function handler(args) {
-    const projectId = requireProjectId(args["project"] ?? args["project_id"]);
+    const projectId = await resolveProjectId(requireProjectId(args["project"] ?? args["project_id"]));
     const key = String(args["key"] ?? "").trim();
     const name = String(args["name"] ?? "").trim();
     if (!key || !name)

package/dist/tools/getFlag.js

@@ -1,7 +1,7 @@
 import { callApi } from "../api.js";
 import { requireProjectId } from "../config.js";
 import { okResult } from "../result.js";
-import { listAllFlags } from "../resolvers.js";
+import { listAllFlags, resolveProjectId } from "../resolvers.js";
 export const toolDefinition = {
     name: "get_flag",
     description: "Get a single flag's metadata (id, key, name, type, status, description) by key (preferred) or id.\n" +
@@ -31,7 +31,7 @@ export const toolDefinition = {
     },
 };
 export async function handler(args) {
-    const projectId = requireProjectId(args["project"] ?? args["project_id"]);
+    const projectId = await resolveProjectId(requireProjectId(args["project"] ?? args["project_id"]));
     const flagArg = (args["flag"] ?? args["flag_key"]);
     if (typeof flagArg !== "string" || flagArg.trim() === "") {
         throw new Error("`flag` (key or id) is required.");

package/dist/tools/getFlagValues.js

@@ -1,7 +1,7 @@
 import { callApi } from "../api.js";
 import { requireProjectId } from "../config.js";
 import { okResult } from "../result.js";
-import { listAllEnvironments, resolveEnvironmentId, resolveFlag, } from "../resolvers.js";
+import { listAllEnvironments, resolveEnvironmentId, resolveFlag, resolveProjectId, } from "../resolvers.js";
 export const toolDefinition = {
     name: "get_flag_values",
     description: "Get a flag's value across all environments, or a single environment when `environment` is given.\n" +
@@ -34,7 +34,7 @@ export const toolDefinition = {
     },
 };
 export async function handler(args) {
-    const projectId = requireProjectId(args["project"] ?? args["project_id"]);
+    const projectId = await resolveProjectId(requireProjectId(args["project"] ?? args["project_id"]));
     const flagArg = (args["flag"] ?? args["flag_key"]);
     if (typeof flagArg !== "string" || flagArg.trim() === "") {
         throw new Error("`flag` (key or id) is required.");

package/dist/tools/listEnvironments.js

@@ -1,6 +1,6 @@
 import { requireProjectId } from "../config.js";
 import { okResult } from "../result.js";
-import { listAllEnvironments } from "../resolvers.js";
+import { listAllEnvironments, resolveProjectId } from "../resolvers.js";
 export const toolDefinition = {
     name: "list_environments",
     description: "List all environments in a project (e.g. dev, staging, prod), each with id, slug, and is_sensitive.\n" +
@@ -24,7 +24,7 @@ export const toolDefinition = {
     },
 };
 export async function handler(args) {
-    const projectId = requireProjectId(args["project"] ?? args["project_id"]);
+    const projectId = await resolveProjectId(requireProjectId(args["project"] ?? args["project_id"]));
     const envs = await listAllEnvironments(projectId);
     const items = envs.map((e) => ({
         id: e.id,

package/dist/tools/listFlags.js

@@ -1,7 +1,7 @@
 import { callApi } from "../api.js";
 import { requireProjectId } from "../config.js";
 import { okResult } from "../result.js";
-import { listAllFlags, resolveEnvironment, } from "../resolvers.js";
+import { listAllFlags, resolveEnvironment, resolveProjectId, } from "../resolvers.js";
 export const toolDefinition = {
     name: "list_flags",
     description: "List flags in a project, optionally filtered by status/search and showing each flag's value in one environment.\n" +
@@ -41,7 +41,7 @@ export const toolDefinition = {
     },
 };
 export async function handler(args) {
-    const projectId = requireProjectId(args["project"] ?? args["project_id"]);
+    const projectId = await resolveProjectId(requireProjectId(args["project"] ?? args["project_id"]));
     const status = typeof args["status"] === "string" ? args["status"] : undefined;
     const search = typeof args["search"] === "string" && args["search"].trim() !== ""
         ? args["search"].toLowerCase().trim()

package/dist/tools/setFlagValue.js

@@ -2,7 +2,7 @@ import { callApi } from "../api.js";
 import { requireProjectId } from "../config.js";
 import { ApiError, SensitiveConfirmRequiredError } from "../errors.js";
 import { okResult } from "../result.js";
-import { invalidateFlagCache, resolveEnvironment, resolveFlag, } from "../resolvers.js";
+import { invalidateFlagCache, resolveEnvironment, resolveFlag, resolveProjectId, } from "../resolvers.js";
 export const toolDefinition = {
     name: "set_flag_value",
     description: "Set a flag's value in one environment. Supports boolean/string/number/json (replaces the old toggle_flag_value).\n" +
@@ -81,7 +81,7 @@ function pickTypedValue(type, args) {
     }
 }
 export async function handler(args) {
-    const projectId = requireProjectId(args["project"] ?? args["project_id"]);
+    const projectId = await resolveProjectId(requireProjectId(args["project"] ?? args["project_id"]));
     const flagArg = (args["flag"] ?? args["flag_id"]);
     if (typeof flagArg !== "string" || flagArg.trim() === "") {
         throw new Error("`flag` (key or id) is required.");

package/dist/tools/updateFlag.js

@@ -1,7 +1,7 @@
 import { callApi } from "../api.js";
 import { requireProjectId } from "../config.js";
 import { okResult } from "../result.js";
-import { invalidateFlagCache, resolveFlag } from "../resolvers.js";
+import { invalidateFlagCache, resolveFlag, resolveProjectId } from "../resolvers.js";
 export const toolDefinition = {
     name: "update_flag",
     description: "Update a flag's name and/or description. `key` and `type` are immutable and cannot be changed here.\n" +
@@ -36,7 +36,7 @@ export const toolDefinition = {
     },
 };
 export async function handler(args) {
-    const projectId = requireProjectId(args["project"] ?? args["project_id"]);
+    const projectId = await resolveProjectId(requireProjectId(args["project"] ?? args["project_id"]));
     const flagArg = (args["flag"] ?? args["flag_id"]);
     if (typeof flagArg !== "string" || flagArg.trim() === "") {
         throw new Error("`flag` (key or id) is required.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@greenflags/mcp",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "MCP server for GreenFlags feature flag management",
   "type": "module",
   "engines": {