anyapi-mcp-server 1.1.2 → 1.1.3

package/build/api-client.js

@@ -1,5 +1,5 @@
 import { withRetry, RetryableError, isRetryableStatus } from "./retry.js";
-import { buildCacheKey, getCached, setCache } from "./response-cache.js";
+import { buildCacheKey, consumeCached, setCache } from "./response-cache.js";
 import { logEntry, isLoggingEnabled } from "./logger.js";
 import { parseResponse } from "./response-parser.js";
 const TIMEOUT_MS = 30_000;
@@ -15,14 +15,19 @@ function interpolatePath(pathTemplate, params) {
     });
     return { url, remainingParams: remaining };
 }
-export async function callApi(config, method, pathTemplate, params, body, extraHeaders) {
-    // --- Cache check (GET only) ---
-    const isGet = method === "GET";
-    const cacheKey = isGet
+/**
+ * @param cacheMode
+ *   - "populate" — skip cache read, always fetch, store result (used by call_api)
+ *   - "consume"  — read-and-evict cache, fetch on miss, do NOT re-store (used by query_api)
+ *   - "none"     — no caching at all (default)
+ */
+export async function callApi(config, method, pathTemplate, params, body, extraHeaders, cacheMode = "none") {
+    // --- Cache check (consume mode only) ---
+    const cacheKey = cacheMode !== "none"
         ? buildCacheKey(method, pathTemplate, params, body, extraHeaders)
         : "";
-    if (isGet) {
-        const cached = getCached(cacheKey);
+    if (cacheMode === "consume") {
+        const cached = consumeCached(cacheKey);
         if (cached !== undefined)
             return cached;
     }
@@ -104,8 +109,8 @@ export async function callApi(config, method, pathTemplate, params, body, extraH
             clearTimeout(timeout);
         }
     });
-    // --- Cache store (GET only) ---
-    if (isGet) {
+    // --- Cache store (populate mode only) ---
+    if (cacheMode === "populate") {
         setCache(cacheKey, result);
     }
     return result;

package/build/index.js

@@ -13,7 +13,7 @@ initLogger(config.logPath ?? null);
 const apiIndex = new ApiIndex(config.spec);
 const server = new McpServer({
     name: config.name,
-    version: "1.1.1",
+    version: "1.1.3",
 });
 // --- Tool 1: list_api ---
 server.tool("list_api", `List available ${config.name} API endpoints. ` +
@@ -125,7 +125,7 @@ server.tool("call_api", `Inspect a ${config.name} API endpoint. Makes a real req
         "Overrides default --header values."),
 }, async ({ method, path, params, body, headers }) => {
     try {
-        const data = await callApi(config, method, path, params, body, headers);
+        const data = await callApi(config, method, path, params, body, headers, "populate");
         const endpoint = apiIndex.getEndpoint(method, path);
         const schema = getOrBuildSchema(data, method, path, endpoint?.requestBodySchema);
         const sdl = schemaToSDL(schema);
@@ -223,7 +223,7 @@ server.tool("query_api", `Fetch data from a ${config.name} API endpoint, returni
         .describe("Client-side slice: items to skip in already-fetched response (default: 0). For API pagination, use params instead."),
 }, async ({ method, path, params, body, query, headers, limit, offset }) => {
     try {
-        const rawData = await callApi(config, method, path, params, body, headers);
+        const rawData = await callApi(config, method, path, params, body, headers, "consume");
         const endpoint = apiIndex.getEndpoint(method, path);
         const schema = getOrBuildSchema(rawData, method, path, endpoint?.requestBodySchema);
         const { data, truncated, total } = truncateIfArray(rawData, limit, offset);

package/build/response-cache.js

@@ -23,6 +23,16 @@ export function getCached(key) {
     }
     return entry.data;
 }
+/** Read and immediately evict a cache entry (one-shot consumption). */
+export function consumeCached(key) {
+    const entry = cache.get(key);
+    if (!entry)
+        return undefined;
+    cache.delete(key);
+    if (Date.now() > entry.expiresAt)
+        return undefined;
+    return entry.data;
+}
 export function setCache(key, data, ttlMs = DEFAULT_TTL_MS) {
     cache.set(key, { data, expiresAt: Date.now() + ttlMs });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anyapi-mcp-server",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "A universal MCP server that connects any REST API (via OpenAPI spec) to AI assistants, with GraphQL-style field selection and automatic schema inference.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",