@debugg-ai/debugg-ai-mcp 1.0.58 → 1.0.59

package/README.md

@@ -32,7 +32,7 @@ docker run -i --rm --init -e DEBUGGAI_API_KEY=your_api_key quinnosha/debugg-ai-m
 
 ## Tools
 
-The server exposes **18** tools. The headline one is `check_app_in_browser`; the rest manage projects, environments, credentials, and workflow execution history.
+The server exposes **21** tools. The headline one is `check_app_in_browser`; the rest manage projects, environments, credentials, workflow execution history, and the teams/repos needed to create new projects.
 
 ### `check_app_in_browser`
 
@@ -55,9 +55,17 @@ Runs an AI browser agent against your app. The agent navigates, interacts, and r
 |------|---------|
 | `list_projects` | List projects accessible to your API key. Optional `q` for name/repo search. |
 | `get_project` | Fetch a project by `uuid`. Simplified shape (no team/runner internals). |
+| `create_project` | Create a new project. Needs `name`, `platform` (e.g. `web`), `teamUuid` (from `list_teams`), and `repoUuid` (from `list_repos`). |
 | `update_project` | PATCH a project's `name` or `description`. |
 | `delete_project` | Destructive delete. Cascades envs, creds, and history. |
 
+### Teams and repos (prerequisites for `create_project`)
+
+| Tool | Purpose |
+|------|---------|
+| `list_teams` | Paginated list of teams accessible to the API key; optional `q` for search. |
+| `list_repos` | Paginated list of GitHub-linked repos; optional `q` for search. Use repos with `isGithubAuthorized: true` when creating a project. |
+
 ### Environment management (scoped to a project)
 
 | Tool | Purpose |

package/dist/handlers/createProjectHandler.js

@@ -0,0 +1,31 @@
+import { Logger } from '../utils/logger.js';
+import { handleExternalServiceError } from '../utils/errors.js';
+import { DebuggAIServerClient } from '../services/index.js';
+import { config } from '../config/index.js';
+const logger = new Logger({ module: 'createProjectHandler' });
+export async function createProjectHandler(input, _context) {
+    const start = Date.now();
+    logger.toolStart('create_project', {
+        name: input.name,
+        platform: input.platform,
+        teamUuid: input.teamUuid,
+        repoUuid: input.repoUuid,
+    });
+    try {
+        const client = new DebuggAIServerClient(config.api.key);
+        await client.init();
+        const project = await client.createProject({
+            name: input.name,
+            platform: input.platform,
+            teamUuid: input.teamUuid,
+            repoUuid: input.repoUuid,
+        });
+        const payload = { created: true, project };
+        logger.toolComplete('create_project', Date.now() - start);
+        return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
+    }
+    catch (error) {
+        logger.toolError('create_project', error, Date.now() - start);
+        throw handleExternalServiceError(error, 'DebuggAI', 'create_project');
+    }
+}

package/dist/handlers/index.js

@@ -16,3 +16,6 @@ export * from './deleteProjectHandler.js';
 export * from './listExecutionsHandler.js';
 export * from './getExecutionHandler.js';
 export * from './cancelExecutionHandler.js';
+export * from './listTeamsHandler.js';
+export * from './listReposHandler.js';
+export * from './createProjectHandler.js';

package/dist/handlers/listReposHandler.js

@@ -0,0 +1,27 @@
+import { Logger } from '../utils/logger.js';
+import { handleExternalServiceError } from '../utils/errors.js';
+import { DebuggAIServerClient } from '../services/index.js';
+import { config } from '../config/index.js';
+import { toPaginationParams } from '../utils/pagination.js';
+const logger = new Logger({ module: 'listReposHandler' });
+export async function listReposHandler(input, _context) {
+    const start = Date.now();
+    const pagination = toPaginationParams({ page: input.page, pageSize: input.pageSize });
+    logger.toolStart('list_repos', { q: input.q, ...pagination });
+    try {
+        const client = new DebuggAIServerClient(config.api.key);
+        await client.init();
+        const { pageInfo, repos } = await client.listRepos(pagination, input.q);
+        const payload = {
+            filter: { q: input.q ?? null },
+            pageInfo,
+            repos,
+        };
+        logger.toolComplete('list_repos', Date.now() - start);
+        return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
+    }
+    catch (error) {
+        logger.toolError('list_repos', error, Date.now() - start);
+        throw handleExternalServiceError(error, 'DebuggAI', 'list_repos');
+    }
+}

package/dist/handlers/listTeamsHandler.js

@@ -0,0 +1,27 @@
+import { Logger } from '../utils/logger.js';
+import { handleExternalServiceError } from '../utils/errors.js';
+import { DebuggAIServerClient } from '../services/index.js';
+import { config } from '../config/index.js';
+import { toPaginationParams } from '../utils/pagination.js';
+const logger = new Logger({ module: 'listTeamsHandler' });
+export async function listTeamsHandler(input, _context) {
+    const start = Date.now();
+    const pagination = toPaginationParams({ page: input.page, pageSize: input.pageSize });
+    logger.toolStart('list_teams', { q: input.q, ...pagination });
+    try {
+        const client = new DebuggAIServerClient(config.api.key);
+        await client.init();
+        const { pageInfo, teams } = await client.listTeams(pagination, input.q);
+        const payload = {
+            filter: { q: input.q ?? null },
+            pageInfo,
+            teams,
+        };
+        logger.toolComplete('list_teams', Date.now() - start);
+        return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
+    }
+    catch (error) {
+        logger.toolError('list_teams', error, Date.now() - start);
+        throw handleExternalServiceError(error, 'DebuggAI', 'list_teams');
+    }
+}

package/dist/services/index.js

@@ -132,6 +132,61 @@ export class DebuggAIServerClient {
             projects: response?.results ?? [],
         };
     }
+    async listTeams(pagination, q) {
+        if (!this.tx)
+            throw new Error('Client not initialized — call init() first');
+        const { makePageInfo } = await import('../utils/pagination.js');
+        const params = { page: pagination.page, pageSize: pagination.pageSize };
+        if (q)
+            params.search = q;
+        const response = await this.tx.get('api/v1/teams/', params);
+        return {
+            pageInfo: makePageInfo(pagination.page, pagination.pageSize, response?.count ?? 0, response?.next),
+            teams: (response?.results ?? []).map((t) => ({
+                uuid: t.uuid,
+                name: t.name,
+                description: t.description ?? null,
+                memberCount: t.memberCount ?? 0,
+                ownerCount: t.ownerCount ?? 0,
+                currentUserRole: t.currentUserRole ?? null,
+            })),
+        };
+    }
+    async listRepos(pagination, q) {
+        if (!this.tx)
+            throw new Error('Client not initialized — call init() first');
+        const { makePageInfo } = await import('../utils/pagination.js');
+        const params = { page: pagination.page, pageSize: pagination.pageSize };
+        if (q)
+            params.search = q;
+        const response = await this.tx.get('api/v1/repos/', params);
+        return {
+            pageInfo: makePageInfo(pagination.page, pagination.pageSize, response?.count ?? 0, response?.next),
+            repos: (response?.results ?? []).map((r) => ({
+                uuid: r.uuid,
+                name: r.name,
+                url: r.url ?? '',
+                description: r.description ?? null,
+                isPrivate: !!r.isPrivate,
+                isGithubAuthorized: !!r.isGithubAuthorized,
+                githubAccountLogin: r.githubAccountLogin ?? null,
+            })),
+        };
+    }
+    async createProject(input) {
+        if (!this.tx)
+            throw new Error('Client not initialized — call init() first');
+        // Backend expects `team` and `repo` keys (UUIDs). MCP surfaces them as
+        // teamUuid/repoUuid for clarity about what kind of UUID they are.
+        const body = {
+            name: input.name,
+            platform: input.platform,
+            team: input.teamUuid,
+            repo: input.repoUuid,
+        };
+        const p = await this.tx.post('api/v1/projects/', body);
+        return this.mapProjectDetail(p);
+    }
     /**
      * List environments for a project. Paginated.
      * Optional q filters by name via backend ?search=.

package/dist/tools/createProject.js

@@ -0,0 +1,25 @@
+import { CreateProjectInputSchema } from '../types/index.js';
+import { createProjectHandler } from '../handlers/createProjectHandler.js';
+const DESCRIPTION = `Create a new DebuggAI project. Required: name, platform (e.g. "web"), teamUuid (from list_teams), repoUuid (from list_repos). Returns {created: true, project: {uuid, name, slug, platform, repoName, ...}}. The repo must be GitHub-linked to the account. Use list_teams + list_repos first to discover valid UUIDs.`;
+export function buildCreateProjectTool() {
+    return {
+        name: 'create_project',
+        title: 'Create Project',
+        description: DESCRIPTION,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Project name. Required.', minLength: 1 },
+                platform: { type: 'string', description: 'Platform (e.g. "web"). Required.', minLength: 1 },
+                teamUuid: { type: 'string', description: 'Team UUID (from list_teams). Required.' },
+                repoUuid: { type: 'string', description: 'GitHub repo UUID (from list_repos). Required — repo must be GitHub-linked.' },
+            },
+            required: ['name', 'platform', 'teamUuid', 'repoUuid'],
+            additionalProperties: false,
+        },
+    };
+}
+export function buildValidatedCreateProjectTool() {
+    const tool = buildCreateProjectTool();
+    return { ...tool, inputSchema: CreateProjectInputSchema, handler: createProjectHandler };
+}

package/dist/tools/index.js

@@ -16,6 +16,9 @@ import { buildDeleteProjectTool, buildValidatedDeleteProjectTool } from './delet
 import { buildListExecutionsTool, buildValidatedListExecutionsTool } from './listExecutions.js';
 import { buildGetExecutionTool, buildValidatedGetExecutionTool } from './getExecution.js';
 import { buildCancelExecutionTool, buildValidatedCancelExecutionTool } from './cancelExecution.js';
+import { buildListTeamsTool, buildValidatedListTeamsTool } from './listTeams.js';
+import { buildListReposTool, buildValidatedListReposTool } from './listRepos.js';
+import { buildCreateProjectTool, buildValidatedCreateProjectTool } from './createProject.js';
 let _tools = null;
 let _validatedTools = null;
 const toolRegistry = new Map();
@@ -42,6 +45,9 @@ export function initTools(ctx) {
         buildListExecutionsTool(),
         buildGetExecutionTool(),
         buildCancelExecutionTool(),
+        buildListTeamsTool(),
+        buildListReposTool(),
+        buildCreateProjectTool(),
     ];
     const validated = [
         buildValidatedTestPageChangesTool(ctx),
@@ -62,6 +68,9 @@ export function initTools(ctx) {
         buildValidatedListExecutionsTool(),
         buildValidatedGetExecutionTool(),
         buildValidatedCancelExecutionTool(),
+        buildValidatedListTeamsTool(),
+        buildValidatedListReposTool(),
+        buildValidatedCreateProjectTool(),
     ];
     _tools = tools;
     _validatedTools = validated;

package/dist/tools/listRepos.js

@@ -0,0 +1,23 @@
+import { ListReposInputSchema } from '../types/index.js';
+import { listReposHandler } from '../handlers/listReposHandler.js';
+const DESCRIPTION = `List GitHub repos linked to the current account. Paginated — every response includes pageInfo {page, pageSize, totalCount, totalPages, hasMore}; default pageSize 20, max 200. Optional q filters by repo name via backend search. Use this to discover repoUuid values required by create_project. Prefer repos with isGithubAuthorized:true since the backend needs a valid GitHub installation.`;
+export function buildListReposTool() {
+    return {
+        name: 'list_repos',
+        title: 'List Linked Repos',
+        description: DESCRIPTION,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                q: { type: 'string', description: 'Optional: filter by repo name.' },
+                page: { type: 'number', description: 'Optional: 1-indexed page number.', minimum: 1 },
+                pageSize: { type: 'number', description: 'Optional: items per page. Default 20, max 200.', minimum: 1, maximum: 200 },
+            },
+            additionalProperties: false,
+        },
+    };
+}
+export function buildValidatedListReposTool() {
+    const tool = buildListReposTool();
+    return { ...tool, inputSchema: ListReposInputSchema, handler: listReposHandler };
+}

package/dist/tools/listTeams.js

@@ -0,0 +1,23 @@
+import { ListTeamsInputSchema } from '../types/index.js';
+import { listTeamsHandler } from '../handlers/listTeamsHandler.js';
+const DESCRIPTION = `List teams accessible to the current API key. Paginated — every response includes pageInfo {page, pageSize, totalCount, totalPages, hasMore}; default pageSize 20, max 200. Optional q filters by team name via backend search. Use this to discover teamUuid values required by create_project.`;
+export function buildListTeamsTool() {
+    return {
+        name: 'list_teams',
+        title: 'List Teams',
+        description: DESCRIPTION,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                q: { type: 'string', description: 'Optional: filter by team name.' },
+                page: { type: 'number', description: 'Optional: 1-indexed page number.', minimum: 1 },
+                pageSize: { type: 'number', description: 'Optional: items per page. Default 20, max 200.', minimum: 1, maximum: 200 },
+            },
+            additionalProperties: false,
+        },
+    };
+}
+export function buildValidatedListTeamsTool() {
+    const tool = buildListTeamsTool();
+    return { ...tool, inputSchema: ListTeamsInputSchema, handler: listTeamsHandler };
+}

package/dist/types/index.js

@@ -106,6 +106,22 @@ export const ListProjectsInputSchema = z.object({
     page: z.number().int().min(1).optional(),
     pageSize: z.number().int().min(1).optional(),
 }).strict();
+export const ListTeamsInputSchema = z.object({
+    q: z.string().min(1).optional(),
+    page: z.number().int().min(1).optional(),
+    pageSize: z.number().int().min(1).optional(),
+}).strict();
+export const ListReposInputSchema = z.object({
+    q: z.string().min(1).optional(),
+    page: z.number().int().min(1).optional(),
+    pageSize: z.number().int().min(1).optional(),
+}).strict();
+export const CreateProjectInputSchema = z.object({
+    name: z.string().min(1),
+    platform: z.string().min(1),
+    teamUuid: z.string().uuid(),
+    repoUuid: z.string().uuid(),
+}).strict();
 /**
  * Error types
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@debugg-ai/debugg-ai-mcp",
-  "version": "1.0.58",
+  "version": "1.0.59",
   "description": "Zero-Config, Fully AI-Managed End-to-End Testing for all code gen platforms.",
   "type": "module",
   "bin": {