OfficeRnD MCP Server

Instructions

Implementation Reference

• src/tools/collaboration.ts:149-208 (handler)

  The handler function logic for the collaboration tool, which executes list or get actions based on the provided entity and filters.

      async ({ action, entity, id, status, member, location, startAfter, startBefore, cursorNext, limit }) => {
        try {
          const cfg = ENTITIES[entity];
  
          if (action === "get") {
            if (!id) {
              return {
                content: [{ type: "text" as const, text: "id is required for action=get." }],
                isError: true,
              };
            }
            const item = await apiGet<Record<string, unknown>>(`${cfg.getPath}/${id}`);
            return { content: [{ type: "text" as const, text: cfg.formatter(item) }] };
          }
  
          // list
          const params: Record<string, string> = {};
          if (cursorNext) params["$cursorNext"] = cursorNext;
          if (limit) params["$limit"] = limit;
  
          switch (entity) {
            case "events":
              if (location) params["location"] = location;
              if (startAfter) params["start[$gte]"] = startAfter;
              if (startBefore) params["start[$lt]"] = startBefore;
              break;
            case "tickets":
              if (status) params["status"] = status;
              if (member) params["member"] = member;
              if (location) params["location"] = location;
              break;
          }
  
          const data = await apiGet<PaginatedResponse<Record<string, unknown>>>(cfg.listPath, params);
  
          if (data.results.length === 0) {
            return { content: [{ type: "text" as const, text: `No ${cfg.label} found.` }] };
          }
  
          const text = data.results.map(cfg.formatter).join("\n---\n");
          let result = `Found ${data.results.length} ${cfg.label} (range ${data.rangeStart}-${data.rangeEnd}):\n\n${text}`;
          if (data.cursorNext) {
            result += `\n\n[More results available — use cursorNext: "${data.cursorNext}"]`;
          }
  
          return { content: [{ type: "text" as const, text: result }] };
        } catch (error) {
          return {
            content: [
              {
                type: "text" as const,
                text: `Error querying ${entity}: ${error instanceof Error ? error.message : String(error)}`,
              },
            ],
            isError: true,
          };
        }
      }
    );
  }

• src/tools/collaboration.ts:110-147 (schema)

  The input schema definition using Zod for the collaboration tool.

  inputSchema: {
    action: z.enum(["list", "get"]).describe("Action to perform"),
    entity: z
      .enum(["events", "tickets", "posts"])
      .describe("Entity type to query"),
    id: z
      .string()
      .optional()
      .describe("Entity ID (required for action=get)"),
    status: z
      .string()
      .optional()
      .describe("Filter by status (tickets only)"),
    member: z
      .string()
      .optional()
      .describe("Filter by member ID (tickets only)"),
    location: z
      .string()
      .optional()
      .describe("Filter by location ID (events, tickets)"),
    startAfter: z
      .string()
      .optional()
      .describe("Events starting on/after this ISO date"),
    startBefore: z
      .string()
      .optional()
      .describe("Events starting before this ISO date"),
    cursorNext: z
      .string()
      .optional()
      .describe("Cursor token for next page of results"),
    limit: z
      .string()
      .optional()
      .describe("Results per page (max 50, default 50)"),
  },

• src/tools/collaboration.ts:96-208 (registration)

  Tool registration function for the collaboration tool.

  export function registerCollaborationTool(server: McpServer): void {
    server.registerTool(
      "collaboration",
      {
        title: "Collaboration",
        description: `Query collaboration data in OfficeRnD.
  
  action=list: List entities with optional filters and pagination (max 50 per page).
  action=get: Get a single entity by ID.
  
  Entity-specific filters when listing:
  - events: location, startAfter, startBefore (ISO dates)
  - tickets: status, member, location
  - posts: (pagination only)`,
        inputSchema: {
          action: z.enum(["list", "get"]).describe("Action to perform"),
          entity: z
            .enum(["events", "tickets", "posts"])
            .describe("Entity type to query"),
          id: z
            .string()
            .optional()
            .describe("Entity ID (required for action=get)"),
          status: z
            .string()
            .optional()
            .describe("Filter by status (tickets only)"),
          member: z
            .string()
            .optional()
            .describe("Filter by member ID (tickets only)"),
          location: z
            .string()
            .optional()
            .describe("Filter by location ID (events, tickets)"),
          startAfter: z
            .string()
            .optional()
            .describe("Events starting on/after this ISO date"),
          startBefore: z
            .string()
            .optional()
            .describe("Events starting before this ISO date"),
          cursorNext: z
            .string()
            .optional()
            .describe("Cursor token for next page of results"),
          limit: z
            .string()
            .optional()
            .describe("Results per page (max 50, default 50)"),
        },
      },
      async ({ action, entity, id, status, member, location, startAfter, startBefore, cursorNext, limit }) => {
        try {
          const cfg = ENTITIES[entity];
  
          if (action === "get") {
            if (!id) {
              return {
                content: [{ type: "text" as const, text: "id is required for action=get." }],
                isError: true,
              };
            }
            const item = await apiGet<Record<string, unknown>>(`${cfg.getPath}/${id}`);
            return { content: [{ type: "text" as const, text: cfg.formatter(item) }] };
          }
  
          // list
          const params: Record<string, string> = {};
          if (cursorNext) params["$cursorNext"] = cursorNext;
          if (limit) params["$limit"] = limit;
  
          switch (entity) {
            case "events":
              if (location) params["location"] = location;
              if (startAfter) params["start[$gte]"] = startAfter;
              if (startBefore) params["start[$lt]"] = startBefore;
              break;
            case "tickets":
              if (status) params["status"] = status;
              if (member) params["member"] = member;
              if (location) params["location"] = location;
              break;
          }
  
          const data = await apiGet<PaginatedResponse<Record<string, unknown>>>(cfg.listPath, params);
  
          if (data.results.length === 0) {
            return { content: [{ type: "text" as const, text: `No ${cfg.label} found.` }] };
          }
  
          const text = data.results.map(cfg.formatter).join("\n---\n");
          let result = `Found ${data.results.length} ${cfg.label} (range ${data.rangeStart}-${data.rangeEnd}):\n\n${text}`;
          if (data.cursorNext) {
            result += `\n\n[More results available — use cursorNext: "${data.cursorNext}"]`;
          }
  
          return { content: [{ type: "text" as const, text: result }] };
        } catch (error) {
          return {
            content: [
              {
                type: "text" as const,
                text: `Error querying ${entity}: ${error instanceof Error ? error.message : String(error)}`,
              },
            ],
            isError: true,
          };
        }
      }
    );
  }