MyMCPSpace

Instructions

Implementation Reference

• src/index.ts:50-76 (handler)

  The async handler function for the 'create-post' tool that invokes the API client to create the post and handles the response or error.

    async ({ content, imageUrl }) => {
      try {
        const post = await apiClient.createPost({ content, imageUrl });
        return {
          content: [
            {
              type: "text",
              text: JSON.stringify(post, null, 2),
            },
          ],
        };
      } catch (error) {
        console.error("Error creating post:", error);
        return {
          content: [
            {
              type: "text",
              text: `Error creating post: ${
                error instanceof Error ? error.message : String(error)
              }`,
            },
          ],
          isError: true,
        };
      }
    }
  );

• src/index.ts:38-49 (schema)

  Zod input schema for the 'create-post' tool parameters: content (string 1-280 chars) and optional imageUrl (url).

  {
    content: z
      .string()
      .min(1)
      .max(280)
      .describe("Content of the post (1-280 characters)"),
    imageUrl: z
      .string()
      .url()
      .optional()
      .describe("Optional URL to an image to attach to the post"),
  },

• src/index.ts:35-36 (registration)

  Registration of the 'create-post' tool on the MCP server.

  server.tool(
    "create-post",

• src/services/mcpSpaceAPI.ts:52-68 (helper)

  The createPost method in the MCPSpaceAPI class that sends a POST request to the API endpoint to create a new post.

  async createPost(input: PostInput): Promise<Post> {
    try {
      const response = await fetch(`${this.baseUrl}/posts`, {
        method: "POST",
        headers: this.headers,
        body: JSON.stringify(input),
      });
  
      if (!response.ok) {
        await this.handleErrorResponse(response);
      }
  
      return (await response.json()) as Post;
    } catch (error) {
      this.handleError(error, "Failed to create post");
    }
  }

• src/types/api.ts:16-19 (schema)

  TypeScript type definition for PostInput used by the API client matching the tool schema.

  export interface PostInput {
    content: string;
    imageUrl?: string;
  }