Canvas MCP Server V2.0

Instructions

Implementation Reference

• src/client.ts:684-692 (handler)

  The core Canvas API client method implementing the logic to list announcements for a given course by querying discussion topics with type='announcement'. This is the primary handler logic for the tool.

  async listAnnouncements(courseId: string): Promise<CanvasAnnouncement[]> {
    const response = await this.client.get(`/courses/${courseId}/discussion_topics`, {
      params: {
        type: 'announcement',
        include: ['assignment']
      }
    });
    return response.data;
  }

• src/index.ts:559-568 (registration)

  Tool registration in the TOOLS array, defining the tool name, description, and input schema for MCP tool listing.

    name: "canvas_list_announcements",
    description: "List all announcements in a course",
    inputSchema: {
      type: "object",
      properties: {
        course_id: { type: "number", description: "ID of the course" }
      },
      required: ["course_id"]
    }
  },

• src/index.ts:1013-1015 (handler)

  Usage of the listAnnouncements method in the MCP resource reading handler for announcements://course_id resources.

  case "announcements":
    content = await this.client.listAnnouncements(id);
    break;

• src/types.ts:320-328 (schema)

  TypeScript interface defining the structure of CanvasAnnouncement objects returned by the tool.

  export interface CanvasAnnouncement {
    id: number;
    title: string;
    message: string;
    posted_at: string;
    html_url: string;
    user_has_posted: boolean;
    discussion_subentry_count: number;
  }

• src/index.ts:1071-1073 (registration)

  MCP server registration of all tools including canvas_list_announcements via ListToolsRequestSchema handler.

  this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: TOOLS
  }));