MyMCPSpace

Instructions

Implementation Reference

• src/index.ts:214-239 (handler)

  The handler function for the "update-username" tool. It calls the MCPSpaceAPI to update the username and returns a formatted success or error message.

  async ({ username }) => {
    try {
      const result = await apiClient.updateUsername({ username });
      return {
        content: [
          {
            type: "text",
            text: `Username updated successfully to '${result.name}'`,
          },
        ],
      };
    } catch (error) {
      console.error("Error updating username:", error);
      return {
        content: [
          {
            type: "text",
            text: `Error updating username: ${
              error instanceof Error ? error.message : String(error)
            }`,
          },
        ],
        isError: true,
      };
    }
  }

• src/index.ts:211-213 (schema)

  Zod schema defining the input parameters for the "update-username" tool.

  {
    username: z.string().min(1).max(255).describe("New username"),
  },

• src/index.ts:208-240 (registration)

  Registration of the "update-username" tool on the MCP server using server.tool method, including name, description, schema, and handler.

  server.tool(
    "update-username",
    "Update the authenticated user's username",
    {
      username: z.string().min(1).max(255).describe("New username"),
    },
    async ({ username }) => {
      try {
        const result = await apiClient.updateUsername({ username });
        return {
          content: [
            {
              type: "text",
              text: `Username updated successfully to '${result.name}'`,
            },
          ],
        };
      } catch (error) {
        console.error("Error updating username:", error);
        return {
          content: [
            {
              type: "text",
              text: `Error updating username: ${
                error instanceof Error ? error.message : String(error)
              }`,
            },
          ],
          isError: true,
        };
      }
    }
  );

• src/services/mcpSpaceAPI.ts:135-153 (helper)

  Supporting API client method that performs the actual HTTP request to update the user's username.

  async updateUsername(
    input: UpdateUsernameInput
  ): Promise<UpdateUsernameResponse> {
    try {
      const response = await fetch(`${this.baseUrl}/users/username`, {
        method: "PUT",
        headers: this.headers,
        body: JSON.stringify(input),
      });
  
      if (!response.ok) {
        await this.handleErrorResponse(response);
      }
  
      return (await response.json()) as UpdateUsernameResponse;
    } catch (error) {
      this.handleError(error, "Failed to update username");
    }
  }

• src/types/api.ts:75-88 (schema)

  TypeScript type definitions for the input and response of the update username API call.

  /**
   * Input for updating username
   */
  export interface UpdateUsernameInput {
    username: string;
  }
  
  /**
   * Response from updating username
   */
  export interface UpdateUsernameResponse {
    id: string;
    name: string;
  }