Canny MCP Server

Instructions

Implementation Reference

• src/tools/posts.ts:77-113 (handler)

  The main handler function for the 'get_posts' tool. It validates the input parameters using Zod schema, calls the Canny client to fetch posts from a board, handles errors, processes the posts data, and returns a formatted string summary of the posts.

  handler: async (args: unknown, client: CannyClient) => {
    const { boardId, limit, skip, status, search, sort } = validateToolInput<GetPostsInput>(args, GetPostsSchema);
    
    const response = await client.getPosts(boardId, { limit, skip, status, search, sort });
    
    if (response.error) {
      throw new Error(`Failed to fetch posts: ${response.error}`);
    }
  
    if (!response.data?.posts || response.data.posts.length === 0) {
      return 'No posts found matching the criteria.';
    }
  
    const posts = response.data.posts.map(post => ({
      id: post.id,
      title: post.title,
      details: post.details?.substring(0, 200) + (post.details && post.details.length > 200 ? '...' : ''),
      status: post.status,
      author: post.author.name,
      votes: post.votes,
      score: post.score,
      tags: post.tags.map(tag => tag.name),
      createdAt: new Date(post.createdAt).toLocaleDateString(),
      url: post.url,
    }));
  
    return `Found ${posts.length} post(s) in board ${boardId}:\n\n${posts
      .map((post, index) => 
        `${index + 1}. **${post.title}** (ID: ${post.id})\n` +
        `   Status: ${post.status} | Votes: ${post.votes} | Score: ${post.score}\n` +
        `   Author: ${post.author} | Created: ${post.createdAt}\n` +
        `   Tags: ${post.tags.length > 0 ? post.tags.join(', ') : 'None'}\n` +
        `   Details: ${post.details || 'No description'}\n` +
        `   URL: ${post.url}\n`
      )
      .join('\n')}${response.data.hasMore ? '\n(More posts available - increase limit or skip to see more)' : ''}`;
  },

• src/tools/posts.ts:56-76 (schema)

  The JSON schema defining the input parameters for the 'get_posts' tool, including boardId (required), pagination, filtering by status/search/sort options.

  inputSchema: {
    type: 'object',
    properties: {
      boardId: { type: 'string', description: 'ID of the board to fetch posts from' },
      limit: { type: 'number', minimum: 1, maximum: 50, default: 10, description: 'Number of posts to retrieve' },
      skip: { type: 'number', minimum: 0, default: 0, description: 'Number of posts to skip for pagination' },
      status: { 
        type: 'string', 
        enum: ['open', 'under review', 'planned', 'in progress', 'complete', 'closed'],
        description: 'Filter by post status' 
      },
      search: { type: 'string', description: 'Search term to filter posts' },
      sort: { 
        type: 'string', 
        enum: ['newest', 'oldest', 'relevance', 'trending'],
        description: 'Sort order for posts' 
      },
    },
    required: ['boardId'],
    additionalProperties: false,
  },

• src/tools/posts.ts:5-12 (schema)

  Zod schema used internally for runtime validation of get_posts tool inputs before calling the Canny client.

  const GetPostsSchema = z.object({
    boardId: z.string().min(1, 'Board ID is required'),
    limit: z.number().min(1).max(50).optional().default(10),
    skip: z.number().min(0).optional().default(0),
    status: z.enum(['open', 'under review', 'planned', 'in progress', 'complete', 'closed']).optional(),
    search: z.string().optional(),
    sort: z.enum(['newest', 'oldest', 'relevance', 'trending']).optional(),
  });

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

  The main tools array registration where getPostsTool is included (line 34) among other Canny MCP tools.

  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/tools/index.ts:3-9 (registration)

  Import statement that brings the getPostsTool into the index module for registration in the tools array.

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