Canny MCP Server

Instructions

Implementation Reference

• src/tools/posts.ts:120-158 (handler)

  Core implementation of the 'get_post' tool, including name, description, input schema, and handler function that validates input, calls the Canny API client, handles errors, and returns formatted post details.

  export const getPostTool = {
    name: 'get_post',
    description: 'Get detailed information about a specific Canny post',
    inputSchema: {
      type: 'object',
      properties: {
        postId: { type: 'string', description: 'ID of the post to retrieve' },
      },
      required: ['postId'],
      additionalProperties: false,
    },
    handler: async (args: unknown, client: CannyClient) => {
      const { postId } = validateToolInput<GetPostInput>(args, GetPostSchema);
      
      const response = await client.getPost(postId);
      
      if (response.error) {
        throw new Error(`Failed to fetch post: ${response.error}`);
      }
  
      if (!response.data) {
        return `Post with ID ${postId} not found.`;
      }
  
      const post = response.data;
      return `**${post.title}**\n` +
        `ID: ${post.id}\n` +
        `Status: ${post.status}\n` +
        `Author: ${post.author.name} (${post.author.email || 'No email'})\n` +
        `Board: ${post.board.name}\n` +
        `Category: ${post.category?.name || 'None'}\n` +
        `Votes: ${post.votes} | Score: ${post.score}\n` +
        `Tags: ${post.tags.length > 0 ? post.tags.map(tag => tag.name).join(', ') : 'None'}\n` +
        `Created: ${new Date(post.createdAt).toLocaleString()}\n` +
        `Updated: ${new Date(post.updatedAt).toLocaleString()}\n` +
        `URL: ${post.url}\n\n` +
        `**Details:**\n${post.details || 'No description provided'}`;
    },
  };

• src/tools/posts.ts:14-16 (schema)

  Zod validation schema for get_post tool input parameters.

  const GetPostSchema = z.object({
    postId: z.string().min(1, 'Post ID is required'),
  });

• src/tools/index.ts:29-45 (registration)

  Registration of all tools including getPostTool in the main tools export array used for MCP tool discovery.

  export const tools: Tool[] = [
    // Board management
    getBoardsTool,
    
    // Post management
    getPostsTool,
    getPostTool,
    searchPostsTool,
    createPostTool,
    updatePostTool,
  
    // Extended functionality - temporarily disabled for debugging
    // getCategoresTool,
    // getCommentsTool,
    // getUsersTool,
    // getTagsTool,
  ];

• src/client/canny.ts:143-149 (helper)

  CannyClient method invoked by the get_post handler to retrieve post data from the Canny API.

  async getPost(postId: string): Promise<CannyApiResponse<CannyPost>> {
    return this.makeRequest<CannyPost>({
      method: 'GET',
      url: '/posts/retrieve',
      params: { id: postId },
    });
  }

• src/tools/index.ts:3-9 (registration)

  Import statement that brings getPostTool into the index for registration.

  import { 
    getPostsTool, 
    getPostTool, 
    searchPostsTool, 
    createPostTool, 
    updatePostTool 
  } from './posts.js';