Connect Tokeet to Claude

mkdir tokeet-mcp && cd tokeet-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 BASE = "https://capi.tokeet.com/v1";
const API_KEY = process.env.TOKEET_API_KEY;
const ACCOUNT = process.env.TOKEET_ACCOUNT_ID;
const INQUIRY_FEED = process.env.TOKEET_INQUIRY_FEED_URL; // optional

if (!API_KEY || !ACCOUNT) {
  console.error("Set TOKEET_API_KEY and TOKEET_ACCOUNT_ID first.");
  process.exit(1);
}

// Every CAPI request: raw API key in the Authorization header,
// account id on the query string.
async function capiGet(path, params = {}) {
  const url = new URL(`${BASE}${path}`);
  url.searchParams.set("account", ACCOUNT);
  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: API_KEY, Accept: "application/json" },
  });
  const text = await res.text();
  if (!res.ok) throw new Error(`Tokeet CAPI ${res.status}: ${text.slice(0, 400)}`);
  return text;
}

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

const asText = (text) => ({ content: [{ type: "text", text }] });

server.tool(
  "list-rentals",
  "List all rentals in the Tokeet account. Returns each rental's id (pkey), name, address, and settings. Run this first to discover rental ids.",
  {},
  async () => asText(await capiGet("/rental"))
);

server.tool(
  "get-rental",
  "Get one rental's full record by its pkey.",
  { rental_pkey: z.string().describe("Rental id from list-rentals") },
  async ({ rental_pkey }) => asText(await capiGet(`/rental/${rental_pkey}`))
);

server.tool(
  "get-rental-availability",
  "Get the availability calendar for one rental.",
  { rental_pkey: z.string().describe("Rental id from list-rentals") },
  async ({ rental_pkey }) =>
    asText(await capiGet(`/rental/${rental_pkey}/availability`))
);

server.tool(
  "list-guests",
  "List guests. Supports pagination (limit/skip), sort (1 asc, -1 desc), booked=1 for guests with bookings, source (e.g. airbnb), and a name filter.",
  {
    limit: z.number().optional().describe("Max records, e.g. 100"),
    skip: z.number().optional().describe("Records to skip for pagination"),
    sort: z.number().optional().describe("1 ascending, -1 descending"),
    booked: z.number().optional().describe("1 = only guests with bookings"),
    source: z.string().optional().describe("Channel filter, e.g. airbnb"),
    name: z.string().optional().describe("Name search"),
  },
  async (params) => asText(await capiGet("/guest", params))
);

server.tool(
  "get-guest-by-email",
  "Look up a guest record by email address.",
  { email: z.string().describe("Guest email") },
  async ({ email }) =>
    asText(await capiGet(`/guest/email/${encodeURIComponent(email)}`))
);

server.tool(
  "list-tasks",
  "List all tasks in the account (cleaning, maintenance, anything on a task list). Tasks can carry a rental id, inquiry id, assigned user, and due date.",
  {},
  async () => asText(await capiGet("/task"))
);

server.tool(
  "list-expenses",
  "List expenses. Supports limit, skip, and sort (1 asc, -1 desc). Expenses carry amount, status (1 unpaid, 2 paid), method, and an optional rental or inquiry id.",
  {
    limit: z.number().optional(),
    skip: z.number().optional(),
    sort: z.number().optional(),
  },
  async (params) => asText(await capiGet("/expense", params))
);

// Bookings: the published Client API has no inquiry/booking endpoint.
// Tokeet's answer is the Inquiry data feed (Settings > Data Feeds), a
// secure CSV URL. 1000 records max per request; filter with booked=1,
// start/end dates, rental=<id>, and paginate with skip/limit.
if (INQUIRY_FEED) {
  server.tool(
    "list-bookings",
    "Fetch the Tokeet Inquiry data feed as CSV. Defaults to booked inquiries only. Returns up to 1000 rows per call; use skip/limit to page.",
    {
      booked: z.number().optional().describe("1 = only booked inquiries (default 1)"),
      start: z.string().optional().describe("Bookings starting on/after, YYYY-MM-DD"),
      end: z.string().optional().describe("Bookings ending on/before, YYYY-MM-DD"),
      rental: z.string().optional().describe("Limit to one rental id"),
      skip: z.number().optional(),
      limit: z.number().optional(),
    },
    async (params) => {
      const url = new URL(INQUIRY_FEED);
      const merged = { booked: 1, ...params };
      for (const [k, v] of Object.entries(merged)) {
        if (v !== undefined && v !== null && v !== "") url.searchParams.set(k, String(v));
      }
      const res = await fetch(url);
      if (!res.ok) throw new Error(`Data feed ${res.status}`);
      return asText(await res.text());
    }
  );
}

const transport = new StdioServerTransport();
await server.connect(transport);

{
  "mcpServers": {
    "tokeet": {
      "command": "node",
      "args": ["/absolute/path/to/tokeet-mcp/index.js"],
      "env": {
        "TOKEET_API_KEY": "your-api-key",
        "TOKEET_ACCOUNT_ID": "your-account-id",
        "TOKEET_INQUIRY_FEED_URL": "https://...your-inquiry-feed-url..."
      }
    }
  }
}

claude mcp add tokeet \
  -e TOKEET_API_KEY=your-api-key \
  -e TOKEET_ACCOUNT_ID=your-account-id \
  -e TOKEET_INQUIRY_FEED_URL="https://...feed..." \
  -- node /absolute/path/to/tokeet-mcp/index.js