Connect Safely to Claude

mkdir safely-mcp
cd safely-mcp
npm init -y
npm install @modelcontextprotocol/sdk zod

{
  "name": "safely-mcp",
  "version": "1.0.0",
  "type": "module",
  "main": "index.js",
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.0.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 { z } from "zod";

const API_KEY = process.env.SAFELY_API_KEY;
const BASE_URL = "https://api.safely.com/api/v1";

if (!API_KEY) {
  console.error("Missing SAFELY_API_KEY environment variable");
  process.exit(1);
}

async function safelyGet(path, params = {}) {
  const url = new URL(`${BASE_URL}${path}`);
  for (const [key, value] of Object.entries(params)) {
    if (value !== undefined && value !== null && value !== "") {
      url.searchParams.append(key, String(value));
    }
  }

  const response = await fetch(url.toString(), {
    method: "GET",
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      Accept: "application/json",
      "User-Agent": "rapideye-safely-mcp/1.0",
    },
  });

  if (!response.ok) {
    const body = await response.text();
    throw new Error(`Safely API ${response.status}: ${body}`);
  }

  return response.json();
}

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

// Tool 1: List properties
server.tool(
  "list-properties",
  "List all properties on the Safely account. Returns property ID, name, address, type, and coverage status. Use this as the entry point for any property-level question.",
  {
    page: z.number().optional().describe("Page number (default: 1)"),
    limit: z.number().optional().describe("Results per page (default: 20)"),
  },
  async ({ page, limit }) => {
    const data = await safelyGet("/properties/", { page, limit });
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

// Tool 2: List reservations
server.tool(
  "list-reservations",
  "List reservations tracked in Safely. Returns reservation details including guest, dates, property, and associated verification status.",
  {
    page: z.number().optional(),
    limit: z.number().optional(),
    property_id: z
      .string()
      .optional()
      .describe("Optional property ID filter"),
  },
  async ({ page, limit, property_id }) => {
    const data = await safelyGet("/reservations/", {
      page,
      limit,
      property_id,
    });
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

// Tool 3: List verifications
server.tool(
  "list-verifications",
  "List guest verifications. Each verification ties a guest to a reservation and has a status (pending, passed, failed, etc). Use this to surface guests who haven't been verified yet or whose verification flagged an issue.",
  {
    page: z.number().optional(),
    limit: z.number().optional(),
  },
  async ({ page, limit }) => {
    const data = await safelyGet("/verifications/", { page, limit });
    return {
      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
    };
  }
);

// Tool 4: List claims
server.tool(
  "list-claims",
  "List damage claims filed through Safely. Returns claim ID, status, loss type, filing date, and associated reservation.",
  {
    page: z.number().optional(),
    limit: z.number().optional(),
  },
  async ({ page, limit }) => {
    const data = await safelyGet("/claims/", { page, limit });
    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": {
    "safely": {
      "command": "node",
      "args": ["/absolute/path/to/safely-mcp/index.js"],
      "env": {
        "SAFELY_API_KEY": "your_safely_api_key_here"
      }
    }
  }
}