Connect CiiRUS to Claude

mkdir ciirus-mcp && cd ciirus-mcp
npm init -y
npm pkg set type="module"
npm install @modelcontextprotocol/sdk zod

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const API_BASE = "https://api.ciiruspartners.com/v2024.07.31";
const USER = process.env.CIIRUS_API_USERNAME;
const PASS = process.env.CIIRUS_API_PASSWORD;

if (!USER || !PASS) {
  console.error("Set CIIRUS_API_USERNAME and CIIRUS_API_PASSWORD first.");
  process.exit(1);
}

// CiiRUS-API auth: Authorization: Basic Base64{APIUsername:APIPassword}
const AUTH = "Basic " + Buffer.from(`${USER}:${PASS}`).toString("base64");

async function get(path, params = {}) {
  const url = new URL(`${API_BASE}${path}`);
  for (const [k, v] of Object.entries(params)) {
    if (v !== undefined && v !== null && v !== "") url.searchParams.set(k, String(v));
  }
  const res = await fetch(url, { headers: { Authorization: AUTH, Accept: "application/json" } });
  if (res.status === 403) throw new Error("403: this machine's IP is not whitelisted with CiiRUS.");
  if (!res.ok) throw new Error(`CiiRUS ${res.status}: ${await res.text()}`);
  return res.json();
}

function json(data) {
  return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
}

const server = new McpServer({ name: "ciirus", version: "1.0.0" });

server.registerTool(
  "list_units",
  {
    description: "List units (properties) in the CiiRUS account. Paginated, 25 per page by default.",
    inputSchema: {
      page: z.number().optional().describe("Page number, default 1"),
      page_size: z.number().optional().describe("Rows per page, default 25"),
      enabled: z.boolean().optional().describe("Filter to enabled units"),
    },
  },
  async ({ page, page_size, enabled }) => json(await get("/units", { page, page_size, enabled }))
);

server.registerTool(
  "list_reservations",
  {
    description: "List reservations, filterable by arrival or departure date range. Dates are ISO date-times.",
    inputSchema: {
      arrival_start: z.string().optional().describe("Earliest arrival, e.g. 2026-07-01T00:00:00Z"),
      arrival_end: z.string().optional().describe("Latest arrival"),
      departure_start: z.string().optional().describe("Earliest departure"),
      departure_end: z.string().optional().describe("Latest departure"),
      unit_id: z.number().optional().describe("Filter to one unit"),
      cancelled: z.boolean().optional().describe("Filter cancelled reservations"),
      page: z.number().optional(),
      page_size: z.number().optional().describe("Rows per page, default 25"),
    },
  },
  async (args) => json(await get("/reservations", args))
);

server.registerTool(
  "get_unit_calendars",
  {
    description: "Availability calendars for units over a date range. start and end are required.",
    inputSchema: {
      start: z.string().describe("Range start, YYYY-MM-DD"),
      end: z.string().describe("Range end, YYYY-MM-DD"),
      unit_id: z.number().optional().describe("Limit to one unit"),
      page: z.number().optional(),
      page_size: z.number().optional(),
    },
  },
  async (args) => json(await get("/unit_calendars", args))
);

server.registerTool(
  "list_reviews",
  {
    description: "List guest reviews.",
    inputSchema: { page: z.number().optional(), page_size: z.number().optional() },
  },
  async (args) => json(await get("/reviews", args))
);

server.registerTool(
  "list_suppliers",
  {
    description: "List suppliers (management companies) visible to these credentials.",
    inputSchema: { page: z.number().optional(), page_size: z.number().optional() },
  },
  async (args) => json(await get("/suppliers", args))
);

const transport = new StdioServerTransport();
await server.connect(transport);
console.error("CiiRUS MCP server running on stdio");

{
  "mcpServers": {
    "ciirus": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/ciirus-mcp/index.js"],
      "env": {
        "CIIRUS_API_USERNAME": "your-api-username",
        "CIIRUS_API_PASSWORD": "your-api-password"
      }
    }
  }
}

claude mcp add \
  --env CIIRUS_API_USERNAME=your-api-username \
  --env CIIRUS_API_PASSWORD=your-api-password \
  --transport stdio ciirus \
  -- node /ABSOLUTE/PATH/TO/ciirus-mcp/index.js