WebSim MCP Server

Instructions

Implementation Reference

• server.js:393-406 (handler)

  The handler function that implements the core logic of the 'get_project_revisions' tool. It parses input arguments, calls the API client to fetch revisions, and returns a formatted JSON response.

  handler: async (args) => {
    const { project_id, limit = 20, offset = 0 } = ProjectIdSchema.parse(args);
    const result = await apiClient.getProjectRevisions(project_id, limit, offset);
    return {
      content: [{
        type: "text",
        text: JSON.stringify({
          success: true,
          data: result,
          message: `Successfully retrieved ${result.items?.length || 0} revisions for project ${project_id}`
        }, null, 2)
      }]
    };
  }

• server.js:373-392 (schema)

  The input schema defining parameters for the get_project_revisions tool: project_id (required), limit, and offset.

  inputSchema: {
    type: "object",
    properties: {
      project_id: {
        type: "string",
        description: "WebSim project ID"
      },
      limit: {
        type: "number",
        description: "Number of revisions to return (default: 20)",
        default: 20
      },
      offset: {
        type: "number",
        description: "Number of revisions to skip (default: 0)",
        default: 0
      }
    },
    required: ["project_id"]
  },

• server.js:370-407 (registration)

  The complete tool registration object added to the tools array, including name, description, inputSchema, and handler.

  {
    name: "get_project_revisions",
    description: "Get all revisions of a WebSim project",
    inputSchema: {
      type: "object",
      properties: {
        project_id: {
          type: "string",
          description: "WebSim project ID"
        },
        limit: {
          type: "number",
          description: "Number of revisions to return (default: 20)",
          default: 20
        },
        offset: {
          type: "number",
          description: "Number of revisions to skip (default: 0)",
          default: 0
        }
      },
      required: ["project_id"]
    },
    handler: async (args) => {
      const { project_id, limit = 20, offset = 0 } = ProjectIdSchema.parse(args);
      const result = await apiClient.getProjectRevisions(project_id, limit, offset);
      return {
        content: [{
          type: "text",
          text: JSON.stringify({
            success: true,
            data: result,
            message: `Successfully retrieved ${result.items?.length || 0} revisions for project ${project_id}`
          }, null, 2)
        }]
      };
    }
  },

• server.js:122-125 (helper)

  The WebSimAPIClient helper method that makes the actual API request to fetch project revisions.

  async getProjectRevisions(projectId, limit = 20, offset = 0) {
    const params = new URLSearchParams({ limit: limit.toString(), offset: offset.toString() });
    return this.makeRequest(`/api/v1/projects/${projectId}/revisions?${params}`);
  }

• server.js:23-25 (schema)

  Shared Zod schema used for input validation in the get_project_revisions handler (and others).

  const ProjectIdSchema = z.object({
    project_id: z.string().describe('WebSim project ID')
  });