feat: Add pagination and field stripping for list_applications (#60)

* docs: remove akuity references (#57)

* remove akuity reference

Signed-off-by: Alexander Matyushentsev <[email protected]>

* remove akuity references

Signed-off-by: Alexander Matyushentsev <[email protected]>

---------

Signed-off-by: Alexander Matyushentsev <[email protected]>
Signed-off-by: Cristina Szumilo <[email protected]>

* Add filtering, pagination, and field stripping

Signed-off-by: Cristina Szumilo <[email protected]>

* linting

Signed-off-by: Cristina Szumilo <[email protected]>

---------

Signed-off-by: Alexander Matyushentsev <[email protected]>
Signed-off-by: Cristina Szumilo <[email protected]>
Co-authored-by: Alexander Matyushentsev <[email protected]>

Author: csz-akuity

src/argocd/client.ts

@@ -21,9 +21,47 @@ export class ArgoCDClient {
     this.client = new HttpClient(this.baseUrl, this.apiToken);
   }
 
-  public async listApplications(params?: { search?: string }) {
-    const { body } = await this.client.get<V1alpha1ApplicationList>(`/api/v1/applications`, params);
-    return body;
+  public async listApplications(params?: { search?: string; limit?: number; offset?: number }) {
+    const { body } = await this.client.get<V1alpha1ApplicationList>(
+      `/api/v1/applications`,
+      params?.search ? { search: params.search } : undefined
+    );
+
+    // Strip heavy fields to reduce token usage
+    const strippedItems =
+      body.items?.map((app) => ({
+        metadata: {
+          name: app.metadata?.name,
+          namespace: app.metadata?.namespace,
+          labels: app.metadata?.labels,
+          creationTimestamp: app.metadata?.creationTimestamp
+        },
+        spec: {
+          project: app.spec?.project,
+          source: app.spec?.source,
+          destination: app.spec?.destination
+        },
+        status: {
+          sync: app.status?.sync,
+          health: app.status?.health,
+          summary: app.status?.summary
+        }
+      })) ?? [];
+
+    // Apply pagination
+    const start = params?.offset ?? 0;
+    const end = params?.limit ? start + params.limit : strippedItems.length;
+    const items = strippedItems.slice(start, end);
+
+    return {
+      items,
+      metadata: {
+        resourceVersion: body.metadata?.resourceVersion,
+        totalItems: strippedItems.length,
+        returnedItems: items.length,
+        hasMore: end < strippedItems.length
+      }
+    };
   }
 
   public async getApplication(applicationName: string) {

src/server/server.ts

@@ -40,10 +40,30 @@ export class Server extends McpServer {
           .optional()
           .describe(
             'Search applications by name. This is a partial match on the application name and does not support glob patterns (e.g. "*"). Optional.'
+          ),
+        limit: z
+          .number()
+          .int()
+          .positive()
+          .optional()
+          .describe(
+            'Maximum number of applications to return. Use this to reduce token usage when there are many applications. Optional.'
+          ),
+        offset: z
+          .number()
+          .int()
+          .min(0)
+          .optional()
+          .describe(
+            'Number of applications to skip before returning results. Use with limit for pagination. Optional.'
           )
       },
-      async ({ search }) =>
-        await this.argocdClient.listApplications({ search: search ?? undefined })
+      async ({ search, limit, offset }) =>
+        await this.argocdClient.listApplications({
+          search: search ?? undefined,
+          limit,
+          offset
+        })
     );
     this.addJsonOutputTool(
       'get_application',