Connect Barefoot to Claude

mkdir barefoot-mcp
cd barefoot-mcp
npm init -y
npm install @modelcontextprotocol/sdk zod fast-xml-parser

{
  "name": "barefoot-mcp",
  "version": "1.0.0",
  "type": "module",
  "main": "index.js",
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.0.0",
    "fast-xml-parser": "^4.4.0",
    "zod": "^3.22.0"
  }
}

#!/usr/bin/env node
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { XMLParser } from "fast-xml-parser";
import { z } from "zod";

const USERNAME = process.env.BAREFOOT_USERNAME;
const PASSWORD = process.env.BAREFOOT_PASSWORD;
const ACCOUNT = process.env.BAREFOOT_ACCOUNT;
const ENDPOINT =
  "https://portals.barefoot.com/barefootwebservice/BarefootService.asmx";
const NS = "http://www.barefoot.com/Services/";

if (!USERNAME || !PASSWORD || !ACCOUNT) {
  console.error(
    "Missing BAREFOOT_USERNAME, BAREFOOT_PASSWORD, or BAREFOOT_ACCOUNT"
  );
  process.exit(1);
}

const parser = new XMLParser({ ignoreAttributes: false });

function escapeXml(value) {
  return String(value)
    .replaceAll("&", "&")
    .replaceAll("<", "<")
    .replaceAll(">", ">")
    .replaceAll('"', """)
    .replaceAll("'", "'");
}

async function callBarefoot(operation, params = {}) {
  const fields = {
    username: USERNAME,
    password: PASSWORD,
    barefootAccount: ACCOUNT,
    ...params,
  };
  const body = Object.entries(fields)
    .map(([key, value]) => `<${key}>${escapeXml(value)}</${key}>`)
    .join("");
  const envelope =
    `<?xml version="1.0" encoding="utf-8"?>` +
    `<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">` +
    `<soap:Body><${operation} xmlns="${NS}">${body}</${operation}>` +
    `</soap:Body></soap:Envelope>`;

  const response = await fetch(ENDPOINT, {
    method: "POST",
    headers: {
      "Content-Type": "text/xml; charset=utf-8",
      SOAPAction: `"${NS}${operation}"`,
    },
    body: envelope,
  });

  const text = await response.text();
  if (!response.ok) {
    throw new Error(`Barefoot API ${response.status}: ${text.slice(0, 500)}`);
  }

  // Parse the envelope; many operations return XML nested inside
  // a <OperationName>Result string, so parse that too if present.
  const parsed = parser.parse(text);
  const resultKey = `${operation}Result`;
  const resultNode = JSON.stringify(parsed).includes(resultKey)
    ? parsed["soap:Envelope"]?.["soap:Body"]?.[`${operation}Response`]?.[
        resultKey
      ]
    : null;
  if (typeof resultNode === "string" && resultNode.trim().startsWith("<")) {
    return parser.parse(resultNode);
  }
  return resultNode ?? parsed;
}

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

// Tool 1: List all properties
server.tool(
  "get-all-properties",
  "List all properties in the Barefoot account via the GetAllProperty operation. Returns the full property list with IDs. Use this first to discover property IDs for other queries.",
  {},
  async () => {
    const data = await callBarefoot("GetAllProperty");
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

// Tool 2: Availability across a date range
server.tool(
  "get-availability-by-date",
  "Check which properties are available between two dates via the GetPropertyAvailabilityByDate operation.",
  {
    date1: z.string().describe("Start date, e.g. 2026-08-08"),
    date2: z.string().describe("End date, e.g. 2026-08-15"),
    weekly: z
      .string()
      .optional()
      .describe("Weekly-rental flag if your account uses it, e.g. 'false'"),
  },
  async ({ date1, date2, weekly }) => {
    const data = await callBarefoot("GetPropertyAvailabilityByDate", {
      date1,
      date2,
      weekly: weekly ?? "false",
    });
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

// Tool 3: Generic read operation
server.tool(
  "call-barefoot-operation",
  "Call any read-only Barefoot web service operation by name, e.g. GetPropertyDetails, GetPropertyRates, GetTenantList, GetOwners, GetGuestReservations. Credentials are added automatically. Check the operation's page at BarefootService.asmx for its exact parameter names. Never call write operations (PropertyBooking, UpdatePropertyPrice, CancelReservationDW, Add*/Set*/Remove*).",
  {
    operation: z
      .string()
      .describe("Operation name exactly as listed, e.g. GetPropertyRates"),
    params: z
      .record(z.string())
      .optional()
      .describe("Operation parameters as key-value strings"),
  },
  async ({ operation, params }) => {
    if (!/^(Get|Is)/.test(operation)) {
      throw new Error(
        `Blocked: '${operation}' is not a read operation. This server only allows Get*/Is* calls.`
      );
    }
    const data = await callBarefoot(operation, params ?? {});
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

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

~/Library/Application Support/Claude/claude_desktop_config.json

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "barefoot": {
      "command": "node",
      "args": ["/absolute/path/to/barefoot-mcp/index.js"],
      "env": {
        "BAREFOOT_USERNAME": "your_web_service_username",
        "BAREFOOT_PASSWORD": "your_web_service_password",
        "BAREFOOT_ACCOUNT": "your_barefootAccount_string"
      }
    }
  }
}