Scheduling Engine

AI-powered appointment scheduling with staff management, availability windows, and booking automation.

Security Scan

The skill's manifest and runtime instructions are internally consistent with a scheduling API; it asks for no extra credentials or installs, but the service is from an unknown source and will transmit booking data (names/emails/notes) to an external gateway, so verify privacy and the payment flow before use.

Purpose & Capability

Name, description, and the SKILL.md endpoints match a scheduling/booking service (create/list appointments, staff management, availability windows). There are no unrelated required env vars, binaries, or config paths; the declared functionality is proportionate to the described purpose. The only mild oddity is there is no homepage or additional documentation linked in the metadata.

Instruction Scope

Instructions direct the agent to call an external gateway (https://gateway.mcfagentic.com) and include personally identifiable data in requests (attendee names, emails, notes). The SKILL.md does not instruct reading local files or unrelated system state. Because the skill relies on an external paid API, be aware that booking data will be transmitted off-platform to the gateway and meeting links reference meet.mcfagentic.com.

Install Mechanism

No install specification and no code files — this is instruction-only, so nothing will be written to disk or executed locally beyond the agent making HTTP requests. This is the lowest-risk install profile.

Credentials

The skill requests no environment variables or credentials, which is consistent with the manifest. However, it uses an on-chain/payment gating mechanism (x402 USDC on Base) that is not described in detail; the agent or user will need to handle payment externally. There are no unexpected credential requests, but the payment requirement and data sent to the gateway are the main operational considerations.

Persistence & Privilege

always is false and the skill does not request persistent system-level privileges. Model invocation is enabled (default), which is normal for skills; there is no indication the skill modifies other skills or system-wide settings.

Assessment

This skill appears to be a straightforward wrapper around a paid external scheduling API, but it comes from an unknown source and will send booking data (names, emails, notes) to an external gateway. Before installing: 1) Verify the gateway domain and service provider (ask for documentation or a homepage). 2) Understand the payment flow (how the x402/USDC payment is initiated, and whether any private keys or payment tokens are required). 3) Confirm privacy and retention policies (what data is stored, for how long, and who can access it). 4) Test with non-sensitive dummy bookings to observe behavior and returned meeting links. 5) If you need stronger guarantees, request an API key/auth method and an audit/logging policy from the provider. If any of these are unclear or you cannot verify the provider, treat the skill cautiously.

Manage appointments, staff schedules, and availability windows programmatically. Built for AI agents that need to book meetings, manage calendars, and coordinate schedules as part of sales, service, or operations workflows. Handles timezone conversion, conflict detection, and smart slot suggestions.

Authentication

All endpoints require x402 payment (USDC on Base L2). Send a request without payment to receive pricing info in the 402 response.

Endpoints

Create Appointment

• Method: POST
• Path: /api/scheduling/appointments
• Price: $0.05 per call
• Description: Book an appointment. Automatically checks for conflicts and confirms availability.

Request:

{
  "title": "Discovery Call - Comfort Zone HVAC",
  "start_time": "2026-04-03T10:00:00-05:00",
  "duration_minutes": 30,
  "staff_id": "staff_cameron",
  "attendees": [
    {"name": "Mike Torres", "email": "[e-mail]"}
  ],
  "type": "discovery-call",
  "notes": "Interested in AI scheduling bundle, $497/mo",
  "send_confirmation": true
}

Response:

{
  "id": "apt_6r2nw8",
  "title": "Discovery Call - Comfort Zone HVAC",
  "start_time": "2026-04-03T10:00:00-05:00",
  "end_time": "2026-04-03T10:30:00-05:00",
  "staff_id": "staff_cameron",
  "status": "confirmed",
  "confirmation_sent": true,
  "meeting_link": "https://meet.mcfagentic.com/apt_6r2nw8"
}

List Appointments

• Method: GET
• Path: /api/scheduling/appointments
• Price: $0.02 per call
• Description: List appointments with optional filters for date range, staff, and status.

Request:

GET /api/scheduling/appointments?staff_id=staff_cameron&start_date=2026-04-01&end_date=2026-04-07

Response:

{
  "appointments": [
    {
      "id": "apt_6r2nw8",
      "title": "Discovery Call - Comfort Zone HVAC",
      "start_time": "2026-04-03T10:00:00-05:00",
      "duration_minutes": 30,
      "status": "confirmed"
    }
  ],
  "total": 1
}

Manage Staff

• Method: POST
• Path: /api/scheduling/staff
• Price: $0.03 per call
• Description: Create or update staff profiles. Define who can be booked and their default settings.

Request:

{
  "name": "Cameron Fagan",
  "email": "[e-mail]",
  "timezone": "America/Chicago",
  "default_meeting_duration": 30,
  "booking_buffer_minutes": 15,
  "max_daily_meetings": 8
}

Response:

{
  "id": "staff_cameron",
  "name": "Cameron Fagan",
  "timezone": "America/Chicago",
  "status": "active"
}

Check Availability

• Method: GET
• Path: /api/scheduling/availability-windows
• Price: $0.02 per call
• Description: Get available time slots for a staff member within a date range. Returns bookable windows accounting for existing appointments and buffer times.

Request:

GET /api/scheduling/availability-windows?staff_id=staff_cameron&date=2026-04-03&duration=30

Response:

{
  "staff_id": "staff_cameron",
  "date": "2026-04-03",
  "timezone": "America/Chicago",
  "available_slots": [
    {"start": "09:00", "end": "09:30"},
    {"start": "10:30", "end": "11:00"},
    {"start": "11:00", "end": "11:30"},
    {"start": "13:00", "end": "13:30"},
    {"start": "14:00", "end": "14:30"},
    {"start": "15:00", "end": "15:30"}
  ]
}

Set Availability Windows

• Method: POST
• Path: /api/scheduling/availability-windows
• Price: $0.03 per call
• Description: Define recurring availability windows for a staff member. Set working hours, blocked times, and day-off overrides.

Request:

{
  "staff_id": "staff_cameron",
  "recurring": [
    {"day": "monday", "start": "09:00", "end": "17:00"},
    {"day": "tuesday", "start": "09:00", "end": "17:00"},
    {"day": "wednesday", "start": "09:00", "end": "17:00"},
    {"day": "thursday", "start": "09:00", "end": "17:00"},
    {"day": "friday", "start": "09:00", "end": "12:00"}
  ],
  "blocked": [
    {"date": "2026-04-04", "reason": "Company holiday"}
  ]
}

Response:

{
  "staff_id": "staff_cameron",
  "availability_updated": true,
  "next_available": "2026-04-03T09:00:00-05:00"
}

Use Cases

• A sales agent books a discovery call after a lead expresses interest via email
• An AI receptionist checks availability and schedules appointments from inbound requests
• A service agent coordinates technician schedules for work order fulfillment
• An orchestrator agent manages a consultant's calendar across multiple client engagements
• A follow-up agent reschedules missed appointments automatically

Pricing

Endpoint	Price	Description
/api/scheduling/appointments (POST)	$0.05	Create an appointment
/api/scheduling/appointments (GET)	$0.02	List appointments
/api/scheduling/staff	$0.03	Create/update staff profiles
/api/scheduling/availability-windows (GET)	$0.02	Check available slots
/api/scheduling/availability-windows (POST)	$0.03	Set availability rules