{
  "protocolVersion": "0.3.0",
  "version": "1.2.0",
  "agent_id": "shorekey.ocean_city",
  "name": "Shorekey",
  "description": "Shorekey direct-booking vacation rentals and coastal spotlights for Ocean City, West Ocean City, and Ocean Pines, Maryland ($0 Shorekey guest booking fee).",
  "url": "https://shorekeyocmd.com/a2a",
  "preferredTransport": "JSONRPC",
  "website": "https://shorekeyocmd.com/",
  "destination": "ocean_city",
  "timezone": "America/New_York",
  "interface_version": 1,
  "provider": {
    "organization": "Shorekey · Quantum Atlas",
    "url": "https://shorekeyocmd.com/"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extensions": [
      {
        "uri": "https://github.com/google-a2a/a2a-x402/v0.1",
        "description": "Accepts x402 stablecoin payments on Base Mainnet (eip155:8453 USDC) for merchant Coastal Spotlight packages and links to the Quantum Atlas x402 resource highway.",
        "required": false,
        "params": {
          "x402Version": 2,
          "rail": "usdc",
          "network": "eip155:8453",
          "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "payTo": "0x9b527Bc9D84B3bb7fDcf5C75C43AE6ea51286A24",
          "x402Highway": "https://x402.quantumatlas.xyz"
        }
      },
      {
        "uri": "https://github.com/google-agentic-commerce/ap2/tree/v0.1",
        "description": "Google Agent Payments Protocol (AP2) payment context over A2A. Merchant packages support both x402 Base USDC settlement and Stripe Checkout.",
        "required": false,
        "params": {
          "version": "0.1",
          "rail": "x402"
        }
      },
      {
        "uri": "https://eips.ethereum.org/EIPS/eip-8004",
        "description": "On-chain identity, reputation, and validation via ERC-8004 Trustless Agents registries on Base.",
        "required": false,
        "params": {
          "identityRegistry": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
          "reputationRegistry": "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63",
          "agentRegistry": "eip155:8453:0x8004a169fb4a3325136eb29fa0ceb6d2e539a432",
          "agentId": 311033,
          "registrationPath": "/.well-known/agent-registration.json",
          "fleetDirectoryUrl": "https://agents.quantumatlas.xyz/agents"
        }
      }
    ]
  },
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/plain"
  ],
  "supportedInterfaces": [
    {
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0",
      "url": "https://shorekeyocmd.com/a2a"
    },
    {
      "protocolBinding": "JSONRPC",
      "protocolVersion": "0.3.0",
      "url": "https://shorekeyocmd.com/a2a"
    },
    {
      "protocolBinding": "MCP",
      "protocolVersion": "2025-06-18",
      "url": "https://shorekeyocmd.com/mcp"
    },
    {
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "3.1.0",
      "url": "https://shorekeyocmd.com/openapi.json"
    }
  ],
  "endpoints": {
    "agent_card": "https://shorekeyocmd.com/.well-known/agent-card.json",
    "agent_manifest": "https://shorekeyocmd.com/agent.json",
    "agent_registration": "https://shorekeyocmd.com/.well-known/agent-registration.json",
    "a2a": "https://shorekeyocmd.com/a2a",
    "a2a_api": "https://shorekeyocmd.com/shorekey/api/public/a2a",
    "mcp": "https://shorekeyocmd.com/mcp",
    "mcp_api": "https://shorekeyocmd.com/shorekey/api/public/mcp",
    "openapi": "https://shorekeyocmd.com/openapi.json",
    "ai_catalog": "https://shorekeyocmd.com/.well-known/ai-catalog.json",
    "x402_catalog": "https://shorekeyocmd.com/shorekey/api/public/spotlights/x402/catalog",
    "llms_txt": "https://shorekeyocmd.com/llms.txt"
  },
  "x402_commerce": {
    "x402_version": 2,
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "currency": "USDC",
    "pay_to": "0x9b527Bc9D84B3bb7fDcf5C75C43AE6ea51286A24",
    "merchant_catalog_url": "https://shorekeyocmd.com/shorekey/api/public/spotlights/x402/catalog",
    "spotlight_x402_checkout_url_template": "https://shorekeyocmd.com/shorekey/api/public/spotlights/{spotlight_id_or_slug}/x402-checkout",
    "canonical_x402_highway": "https://x402.quantumatlas.xyz",
    "erc8004_agent_registry": "eip155:8453:0x8004a169fb4a3325136eb29fa0ceb6d2e539a432",
    "erc8004_agent_id": 311033,
    "fleet_identity_directory": "https://agents.quantumatlas.xyz/agents"
  },
  "skills": [
    {
      "id": "stays.houses.list",
      "mcpToolName": "shorekey_list_houses",
      "name": "List Direct Ocean City Vacation Homes",
      "description": "Lists published Ocean City, Maryland vacation rental homes ($0 ShoreKey guest booking fee). When check_in and check_out are provided, filters to homes available for those exact dates and computes stay_total_cents.",
      "tags": [
        "hospitality",
        "vacation-rentals",
        "ocean-city-md",
        "inventory",
        "availability",
        "zero-guest-fee"
      ],
      "examples": [
        "List all available vacation homes in Ocean City for 6 guests from 2027-07-10 to 2027-07-17",
        "Show oceanside homes in Ocean City with at least 3 bedrooms that allow pets"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "sideEffects": "none",
      "httpEndpoint": {
        "method": "GET",
        "url": "https://shorekeyocmd.com/shorekey/api/public/houses"
      },
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "check_in": {
            "type": "string",
            "description": "Optional check-in date (YYYY-MM-DD)."
          },
          "check_out": {
            "type": "string",
            "description": "Optional check-out date (YYYY-MM-DD)."
          },
          "guests": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 1,
            "description": "Minimum guest capacity."
          },
          "side": {
            "type": "string",
            "enum": [
              "ocean",
              "bay",
              "west_oc",
              "ocean_pines"
            ],
            "description": "Optional island side filter."
          },
          "min_street": {
            "type": "integer",
            "minimum": 0,
            "maximum": 146,
            "description": "Minimum Ocean City street number."
          },
          "max_street": {
            "type": "integer",
            "minimum": 0,
            "maximum": 146,
            "description": "Maximum Ocean City street number."
          },
          "min_bedrooms": {
            "type": "integer",
            "minimum": 0,
            "maximum": 20,
            "description": "Minimum bedroom count."
          },
          "pets_allowed": {
            "type": "boolean",
            "description": "When true, only include pet-friendly homes."
          },
          "site": {
            "type": "string",
            "description": "Optional published rental company site_slug filter."
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "required": [
          "count",
          "guest_fee_cents",
          "houses"
        ],
        "properties": {
          "count": {
            "type": "integer"
          },
          "guest_fee_cents": {
            "type": "integer",
            "const": 0
          },
          "currency": {
            "type": "string",
            "const": "USD"
          },
          "houses": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "name",
                "city",
                "bedrooms",
                "bathrooms",
                "max_guests",
                "nightly_rate_cents",
                "booking_url"
              ],
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "city": {
                  "type": "string"
                },
                "bedrooms": {
                  "type": "integer"
                },
                "bathrooms": {
                  "type": "number"
                },
                "max_guests": {
                  "type": "integer"
                },
                "nightly_rate_cents": {
                  "type": "integer"
                },
                "stay_total_cents": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "location_street": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "location_side": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "pets_allowed": {
                  "type": "boolean"
                },
                "instant_book": {
                  "type": "boolean"
                },
                "min_nights": {
                  "type": "integer"
                },
                "booking_url": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    {
      "id": "stays.house.detail",
      "mcpToolName": "shorekey_get_house",
      "name": "Get Vacation Home Public Details & Rules",
      "description": "Returns full public listing details for a published Ocean City home, including bedrooms, bathrooms, bed layout, amenities, house rules, seasonal rate rules, cancellation terms, verified liability insurance status, and guest reviews. Street address and arrival instructions remain locked.",
      "tags": [
        "hospitality",
        "property-detail",
        "seasonal-rates",
        "cancellation-policy",
        "reviews"
      ],
      "examples": [
        "Get full details, seasonal rates, and cancellation policy for house id prop_123"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "sideEffects": "none",
      "httpEndpoint": {
        "method": "GET",
        "url": "https://shorekeyocmd.com/shorekey/api/public/houses/{house_id}"
      },
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "house_id"
        ],
        "properties": {
          "house_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Listed property ID."
          },
          "site": {
            "type": "string",
            "description": "Optional published rental company site_slug."
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "required": [
          "house",
          "booking_url",
          "privacy_boundary"
        ],
        "properties": {
          "house": {
            "type": "object"
          },
          "booking_url": {
            "type": "string"
          },
          "privacy_boundary": {
            "type": "object"
          }
        }
      }
    },
    {
      "id": "stays.house.unavailable",
      "mcpToolName": "shorekey_get_unavailable_dates",
      "name": "Get Unavailable Calendar Dates for a Home",
      "description": "Returns sorted YYYY-MM-DD dates that are unavailable between from and to (up to 400 days) for a listed home without disclosing whether nights are guest bookings or owner blocks.",
      "tags": [
        "calendar",
        "availability",
        "dates"
      ],
      "examples": [
        "Show unavailable dates for house prop_123 from 2027-06-01 to 2027-09-01"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "sideEffects": "none",
      "httpEndpoint": {
        "method": "GET",
        "url": "https://shorekeyocmd.com/shorekey/api/public/houses/{house_id}/unavailable?from={YYYY-MM-DD}&to={YYYY-MM-DD}"
      },
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "house_id"
        ],
        "properties": {
          "house_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Listed property ID."
          },
          "from": {
            "type": "string",
            "description": "Start date (YYYY-MM-DD). Defaults to today in Ocean City."
          },
          "to": {
            "type": "string",
            "description": "End date (YYYY-MM-DD). Defaults to 90 days after from."
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "required": [
          "house_id",
          "from",
          "to",
          "unavailable_dates"
        ],
        "properties": {
          "house_id": {
            "type": "string"
          },
          "from": {
            "type": "string"
          },
          "to": {
            "type": "string"
          },
          "unavailable_dates": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    },
    {
      "id": "stays.house.quote",
      "mcpToolName": "shorekey_quote_stay",
      "name": "Compute Itemized Stay Quote & Availability Check",
      "description": "Computes an exact, zero-side-effect stay quote in USD cents (nightly breakdown, cleaning fee, local tax, $0 ShoreKey guest fee, deposit/balance schedule, and cancellation policy) or returns plain-English availability problems and suggested alternative stay windows. Never holds nights or initiates charges.",
      "tags": [
        "quote",
        "pricing",
        "availability",
        "zero-side-effect",
        "checkout-handoff"
      ],
      "examples": [
        "Quote house prop_123 from 2027-07-03 to 2027-07-10 for 4 guests"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "sideEffects": "none",
      "httpEndpoint": {
        "method": "GET",
        "url": "https://shorekeyocmd.com/shorekey/api/public/houses/{house_id}/quote?check_in={YYYY-MM-DD}&check_out={YYYY-MM-DD}&guests={n}"
      },
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "house_id",
          "check_in",
          "check_out"
        ],
        "properties": {
          "house_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Listed property ID."
          },
          "check_in": {
            "type": "string",
            "description": "Check-in date (YYYY-MM-DD)."
          },
          "check_out": {
            "type": "string",
            "description": "Check-out date (YYYY-MM-DD)."
          },
          "guests": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 2,
            "description": "Total guest count."
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "required": [
          "house_id",
          "available",
          "problems",
          "quote",
          "guest_fee_cents",
          "guest_checkout_url",
          "authority_boundary"
        ],
        "properties": {
          "house_id": {
            "type": "string"
          },
          "available": {
            "type": "boolean"
          },
          "problems": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "quote": {
            "type": [
              "object",
              "null"
            ]
          },
          "cancellation": {
            "type": "object"
          },
          "payment": {
            "type": "object"
          },
          "suggested_stays": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "guest_fee_cents": {
            "type": "integer",
            "const": 0
          },
          "guest_checkout_url": {
            "type": "string"
          },
          "authority_boundary": {
            "type": "object"
          }
        }
      }
    },
    {
      "id": "mobility.corridor.availability",
      "mcpToolName": "shorekey_corridor_availability",
      "name": "Check Ocean City Corridor Availability by Street",
      "description": "Finds bookable stay windows at a specific Ocean City street number (0..146) between from and to for a given stay length (nights) and guest count, returning sanitized pricing and direct booking links without exposing street addresses.",
      "tags": [
        "corridor",
        "street-search",
        "ocean-city-md",
        "availability"
      ],
      "examples": [
        "Check 3-night corridor availability at 45th Street for 4 guests over the next 30 days"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "sideEffects": "none",
      "httpEndpoint": {
        "method": "GET",
        "url": "https://shorekeyocmd.com/shorekey/api/public/corridor-availability?street={0..146}&from={YYYY-MM-DD}&to={YYYY-MM-DD}&nights={1..28}&guests={1..50}"
      },
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "street"
        ],
        "properties": {
          "street": {
            "type": "integer",
            "minimum": 0,
            "maximum": 146,
            "description": "Ocean City street number (0 = Inlet, 146 = Delaware line)."
          },
          "from": {
            "type": "string",
            "description": "Window start date (YYYY-MM-DD). Defaults to today in Ocean City."
          },
          "to": {
            "type": "string",
            "description": "Window end date (YYYY-MM-DD). Defaults to 60 days after from."
          },
          "nights": {
            "type": "integer",
            "minimum": 1,
            "maximum": 28,
            "default": 7,
            "description": "Stay length in nights."
          },
          "guests": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 2,
            "description": "Number of guests."
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "required": [
          "street",
          "from",
          "to",
          "nights",
          "guests",
          "booking_recheck_required",
          "homes"
        ],
        "properties": {
          "street": {
            "type": "integer"
          },
          "from": {
            "type": "string"
          },
          "to": {
            "type": "string"
          },
          "nights": {
            "type": "integer"
          },
          "guests": {
            "type": "integer"
          },
          "generated_at": {
            "type": "string"
          },
          "max_stays_per_home": {
            "type": "integer"
          },
          "booking_recheck_required": {
            "type": "boolean"
          },
          "homes": {
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        }
      }
    },
    {
      "id": "concierge.spotlights.list",
      "mcpToolName": "shorekey_list_spotlights",
      "name": "List Ocean City Coastal Spotlights & VIP Guest Perks",
      "description": "Lists active, partner-approved Ocean City dining, marina, and experience perks with FTC disclosure labels and VIP pass links. By default excludes Demo Showcase items so agent feeds return only live redeemable offers.",
      "tags": [
        "spotlights",
        "perks",
        "dining",
        "concierge",
        "ocean-city-md"
      ],
      "examples": [
        "List active coastal spotlights and VIP perks in Midtown Ocean City"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "sideEffects": "none",
      "httpEndpoint": {
        "method": "GET",
        "url": "https://shorekeyocmd.com/shorekey/api/public/spotlights"
      },
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "zone": {
            "type": "string",
            "enum": [
              "boardwalk",
              "midtown",
              "north",
              "west_oc",
              "ocean_pines"
            ],
            "description": "Optional island zone filter."
          },
          "channel": {
            "type": "string",
            "enum": [
              "in_home_concierge",
              "bay_boat",
              "tabletop_vip",
              "plane",
              "truck"
            ],
            "description": "Optional QR distribution channel filter."
          },
          "include_demo": {
            "type": "boolean",
            "default": false,
            "description": "When false (default), excludes Demo Showcase items and returns only live merchant offers."
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "required": [
          "schema",
          "count",
          "include_demo",
          "spotlights",
          "billing_package"
        ],
        "properties": {
          "schema": {
            "type": "string",
            "const": "atlas.a2a.shorekey_spotlights.v1"
          },
          "count": {
            "type": "integer"
          },
          "include_demo": {
            "type": "boolean"
          },
          "billing_package": {
            "type": "object"
          },
          "spotlights": {
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        }
      }
    },
    {
      "id": "destination.pulse.read",
      "mcpToolName": "shorekey_destination_pulse",
      "name": "Read Ocean City Destination Pulse & Area Highlights",
      "description": "Returns Ocean City destination discovery context: curated area highlights across all 5 island zones, listed home count, active live spotlight count, and live coastal weather/tide/boardwalk conditions when available.",
      "tags": [
        "destination",
        "ocean-city-md",
        "highlights",
        "weather",
        "tides"
      ],
      "examples": [
        "Read the Ocean City destination pulse and boardwalk highlights"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "sideEffects": "none",
      "httpEndpoint": {
        "method": "GET",
        "url": "https://shorekeyocmd.com/shorekey/api/public/discovery/highlights"
      },
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "zone": {
            "type": "string",
            "enum": [
              "boardwalk",
              "midtown",
              "north",
              "west_oc",
              "ocean_pines"
            ],
            "description": "Optional zone filter for curated area highlights."
          },
          "include_live_pulse": {
            "type": "boolean",
            "default": false,
            "description": "When true, also queries the live Ocean City weather/tide/camera pulse."
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "required": [
          "destination",
          "timezone",
          "highlights"
        ],
        "properties": {
          "destination": {
            "type": "string",
            "const": "ocean_city"
          },
          "timezone": {
            "type": "string",
            "const": "America/New_York"
          },
          "highlights": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "live_pulse": {
            "type": [
              "object",
              "null"
            ]
          }
        }
      }
    },
    {
      "id": "handoffs.stay.prepare",
      "mcpToolName": "shorekey_prepare_stay_handoff",
      "name": "Prepare Human-Approved Stay Checkout or Stay-Request Handoff",
      "description": "Prepares a complete, human-approval-gated checkout link and API submission contract for either a specific listed home (guest_direct_checkout) or an island-wide stay request (stay_request_intake). Places no hold on nights, charges no card, and unlocks no property address.",
      "tags": [
        "handoff",
        "checkout",
        "booking-request",
        "stay-request",
        "human-in-the-loop"
      ],
      "examples": [
        "Prepare a direct checkout handoff for house prop_123 from 2027-07-03 to 2027-07-10 for 4 guests",
        "Prepare an island-wide stay request handoff for 2027-08-01 to 2027-08-08 for 6 guests"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "sideEffects": "none",
      "httpEndpoint": {
        "method": "GET",
        "url": "https://shorekeyocmd.com/stays"
      },
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "check_in",
          "check_out"
        ],
        "properties": {
          "house_id": {
            "type": "string",
            "description": "Optional listed property ID for a direct home checkout handoff. Omit for an island-wide stay request."
          },
          "check_in": {
            "type": "string",
            "description": "Check-in date (YYYY-MM-DD)."
          },
          "check_out": {
            "type": "string",
            "description": "Check-out date (YYYY-MM-DD)."
          },
          "guests": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 2,
            "description": "Number of guests."
          },
          "preferred_zone": {
            "type": "string",
            "enum": [
              "any",
              "boardwalk",
              "midtown",
              "north",
              "west_oc",
              "ocean_pines"
            ],
            "default": "any",
            "description": "Preferred Ocean City zone for island-wide stay requests."
          },
          "budget_max_cents": {
            "type": "integer",
            "minimum": 0,
            "description": "Optional maximum total stay budget in USD cents for stay-request intake."
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "required": [
          "handoff_type",
          "human_checkout_url",
          "terms_version",
          "authority_boundary",
          "api_submission_contract"
        ],
        "properties": {
          "handoff_type": {
            "type": "string",
            "enum": [
              "guest_direct_checkout",
              "stay_request_intake"
            ]
          },
          "human_checkout_url": {
            "type": "string"
          },
          "terms_version": {
            "type": "string"
          },
          "stay_check": {
            "type": [
              "object",
              "null"
            ]
          },
          "authority_boundary": {
            "type": "object"
          },
          "api_submission_contract": {
            "type": "object"
          }
        }
      }
    },
    {
      "id": "merchant.services.catalog",
      "mcpToolName": "shorekey_merchant_services_catalog",
      "name": "List ShoreKey Merchant & Owner Services (x402 & Stripe)",
      "description": "Returns ShoreKey merchant and property-owner service packages, including the $199 30-Day Coastal Spotlight & Concierge Package (Base Mainnet eip155:8453 USDC x402 & Stripe Checkout), the $250/year Property Marketing Package, local Ocean City vendor services (3D tours, drone, photography, turnover cleaning), and Quantum Atlas Switchboard multilingual hospitality voice endpoints.",
      "tags": [
        "merchant-services",
        "x402",
        "usdc",
        "base",
        "spotlights",
        "owner-services",
        "switchboard"
      ],
      "examples": [
        "Show ShoreKey merchant advertising packages, owner services, and x402 payment rates",
        "List Ocean City Coastal Spotlight campaigns available for x402 Base USDC settlement"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "sideEffects": "none",
      "httpEndpoint": {
        "method": "GET",
        "url": "https://shorekeyocmd.com/shorekey/api/public/spotlights/x402/catalog"
      },
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {}
      },
      "outputSchema": {
        "type": "object",
        "required": [
          "schema",
          "protocol",
          "network",
          "currency",
          "asset",
          "pay_to",
          "merchant_packages",
          "spotlights"
        ],
        "properties": {
          "schema": {
            "type": "string"
          },
          "protocol": {
            "type": "string",
            "const": "x402"
          },
          "x402_version": {
            "type": "integer",
            "const": 2
          },
          "network": {
            "type": "string",
            "const": "eip155:8453"
          },
          "currency": {
            "type": "string",
            "const": "USDC"
          },
          "asset": {
            "type": "string"
          },
          "pay_to": {
            "type": "string"
          },
          "canonical_x402_highway": {
            "type": "object"
          },
          "merchant_packages": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "owner_service_listings": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "spotlights": {
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        }
      }
    },
    {
      "id": "merchant.spotlight.x402_checkout",
      "mcpToolName": "shorekey_spotlight_x402_checkout",
      "name": "Quote or Settle a $199 Coastal Spotlight Package via x402 (Base USDC)",
      "description": "Quotes or settles a ShoreKey 30-Day Coastal Spotlight & Concierge Package ($199.00 / 199000000 Base Mainnet USDC atomic units). Calling without payment_signature returns HTTP 402 PaymentRequired requirements (Base eip155:8453 USDC -> Quantum Atlas Treasury) and Stripe Checkout fallback info. Calling with a confirmed Base USDC payment_signature verifies the on-chain Transfer log, records the receipt in spotlight_payment_purchases, activates the 30-day campaign, and returns the merchant report link.",
      "tags": [
        "merchant-services",
        "x402",
        "payment",
        "usdc",
        "base",
        "spotlights"
      ],
      "examples": [
        "Get x402 payment requirements for Coastal Spotlight campaign sp_123",
        "Settle Coastal Spotlight campaign sp_123 with Base USDC transaction hash 0x..."
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "sideEffects": "x402_settlement",
      "httpEndpoint": {
        "method": "POST",
        "url": "https://shorekeyocmd.com/shorekey/api/public/spotlights/{spotlight_id}/x402-checkout"
      },
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "spotlight_id"
        ],
        "properties": {
          "spotlight_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Target Coastal Spotlight ID or venue slug."
          },
          "payment_signature": {
            "type": "string",
            "minLength": 1,
            "maxLength": 65536,
            "description": "Optional x402 v2 payment proof (0x-prefixed 64-hex Base transaction hash, JSON proof, or Base64-encoded x402 PaymentPayload). Omit to receive the 402 PaymentRequired challenge."
          },
          "merchant_email": {
            "type": "string",
            "description": "Optional merchant contact email for the settlement receipt."
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean"
          },
          "settled": {
            "type": "boolean"
          },
          "x402Version": {
            "type": "integer"
          },
          "spotlight_id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "venue_name": {
            "type": "string"
          },
          "amount_cents": {
            "type": "integer"
          },
          "amount_usdc_atomic": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "asset": {
            "type": "string"
          },
          "pay_to": {
            "type": "string"
          },
          "tx_hash": {
            "type": "string"
          },
          "purchase_id": {
            "type": "string"
          },
          "report_url": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        }
      }
    },
    {
      "id": "stays.specials.discover",
      "mcpToolName": "shorekey_discover_unrented_specials",
      "name": "Discover Unrented Last-Minute Specials & Orphan-Gap Windows",
      "description": "Scans published Ocean City vacation homes over the next 3–60 days to surface unrented last-minute stay windows and trapped orphan gaps (1–6 nights between stays or shorter than seasonal minimum nights), complete with recommended direct yield specials, complimentary early check-in / late checkout indicators when adjacent nights are open, bundled Coastal Spotlight VIP dining passes, per-person group split math, $0 ShoreKey guest fee advantage, and 11-language Switchboard outreach previews. Never holds nights or unlocks addresses.",
      "tags": [
        "specials",
        "orphan-gaps",
        "yield",
        "last-minute",
        "multilingual",
        "switchboard",
        "zero-guest-fee"
      ],
      "examples": [
        "Find unrented last-minute specials and orphan gap windows in Ocean City over the next 14 days in Spanish (es-US)",
        "Discover open 2 to 5 night gap windows in Midtown Ocean City for 4 guests"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "sideEffects": "none",
      "httpEndpoint": {
        "method": "GET",
        "url": "https://shorekeyocmd.com/shorekey/api/public/specials"
      },
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "site": {
            "type": "string",
            "description": "Optional published rental company site_slug filter."
          },
          "zone": {
            "type": "string",
            "enum": [
              "boardwalk",
              "midtown",
              "north",
              "west_oc",
              "ocean_pines"
            ],
            "description": "Optional Ocean City zone filter."
          },
          "side": {
            "type": "string",
            "enum": [
              "ocean",
              "bay",
              "west_oc",
              "ocean_pines"
            ],
            "description": "Optional island side filter."
          },
          "guests": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "description": "Minimum guest capacity."
          },
          "max_days_out": {
            "type": "integer",
            "minimum": 3,
            "maximum": 60,
            "default": 21,
            "description": "Horizon in days from today in Ocean City to scan for unrented windows."
          },
          "include_orphan_gaps": {
            "type": "boolean",
            "default": true,
            "description": "When true (default), includes 1–6 night orphan gap windows trapped between bookings or season rules."
          },
          "lang": {
            "type": "string",
            "enum": [
              "es-US",
              "fr-FR",
              "pt-BR",
              "de-DE",
              "it-IT",
              "ja-JP",
              "ko-KR",
              "zh-CN",
              "hi-IN",
              "ar-AR",
              "vi-VN"
            ],
            "default": "es-US",
            "description": "Switchboard target locale for the localized outreach preview card on each special."
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "required": [
          "schema",
          "count",
          "orphan_gap_count",
          "guest_fee_cents",
          "authority_boundary",
          "specials"
        ],
        "properties": {
          "schema": {
            "type": "string",
            "const": "atlas.shorekey.unrented_specials.v1"
          },
          "count": {
            "type": "integer"
          },
          "orphan_gap_count": {
            "type": "integer"
          },
          "active_locale": {
            "type": "string"
          },
          "supported_locales": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "guest_fee_cents": {
            "type": "integer",
            "const": 0
          },
          "authority_boundary": {
            "type": "object"
          },
          "specials": {
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        }
      }
    },
    {
      "id": "marketing.multilingual.package",
      "mcpToolName": "shorekey_package_multilingual_outreach",
      "name": "Package 11-Language Switchboard Hospitality Deal & Voice Broadcast",
      "description": "Generates a localized multilingual marketing and voice outreach package across up to 11 languages (es-US, fr-FR, pt-BR, de-DE, it-IT, ja-JP, ko-KR, zh-CN, hi-IN, ar-AR, vi-VN) for an unrented Ocean City stay window using the canonical hospitality_shorekey glossary, complete with per-person group split math, $0 ShoreKey guest fee comparison, bundled VIP spotlight perks, a ready-to-submit Quantum Atlas Switchboard /switchboard/chunk payload, and human-approved checkout handoff links.",
      "tags": [
        "multilingual",
        "switchboard",
        "marketing",
        "outreach",
        "voice-broadcast",
        "hospitality-glossary"
      ],
      "examples": [
        "Package a multilingual outreach campaign in Spanish, French, Portuguese, and German for house prop_123 from 2027-07-10 to 2027-07-14"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "sideEffects": "none",
      "httpEndpoint": {
        "method": "GET",
        "url": "https://shorekeyocmd.com/shorekey/api/public/specials/multilingual-package"
      },
      "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "house_id",
          "check_in",
          "check_out"
        ],
        "properties": {
          "house_id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Listed property ID."
          },
          "check_in": {
            "type": "string",
            "description": "Check-in date (YYYY-MM-DD)."
          },
          "check_out": {
            "type": "string",
            "description": "Check-out date (YYYY-MM-DD)."
          },
          "guests": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 4,
            "description": "Sample party size for per-person split math."
          },
          "special_pct": {
            "type": "integer",
            "minimum": 0,
            "maximum": 35,
            "description": "Optional direct yield special percentage (0..35). Defaults to urgency-based recommendation."
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "es-US",
                "fr-FR",
                "pt-BR",
                "de-DE",
                "it-IT",
                "ja-JP",
                "ko-KR",
                "zh-CN",
                "hi-IN",
                "ar-AR",
                "vi-VN"
              ]
            },
            "description": "Target Switchboard locales (up to 11). Defaults to [\"es-US\", \"fr-FR\", \"pt-BR\", \"de-DE\"]."
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "required": [
          "schema",
          "house_id",
          "house_name",
          "pricing",
          "preset_glossary",
          "translations",
          "switchboard_job_spec",
          "handoffs"
        ],
        "properties": {
          "schema": {
            "type": "string",
            "const": "atlas.shorekey.multilingual_outreach.v1"
          },
          "house_id": {
            "type": "string"
          },
          "house_name": {
            "type": "string"
          },
          "pricing": {
            "type": "object"
          },
          "value_add_perks": {
            "type": "object"
          },
          "preset_glossary": {
            "type": "string",
            "const": "hospitality_shorekey"
          },
          "english_master_copy": {
            "type": "object"
          },
          "translations": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "switchboard_job_spec": {
            "type": "object"
          },
          "handoffs": {
            "type": "object"
          }
        }
      }
    }
  ],
  "supported_agent_ecosystems": [
    "meta_muse",
    "openai_agents",
    "anthropic_claude_mcp",
    "xai_grok",
    "microsoft_entra_agent_id",
    "a2a_jsonrpc",
    "google_adk"
  ],
  "agent_connection": {
    "guide": "https://api.quantumatlas.xyz/agents/connect",
    "directory": "https://api.quantumatlas.xyz/agents/connectors",
    "mcp": "https://api.quantumatlas.xyz/mcp",
    "direct_mcp": "https://shorekeyocmd.com/mcp",
    "direct_a2a": "https://shorekeyocmd.com/a2a",
    "agent_card": "https://shorekeyocmd.com/.well-known/agent-card.json",
    "openapi": "https://shorekeyocmd.com/openapi.json",
    "permissions": "https://api.quantumatlas.xyz/agents/connections",
    "oauth_authorization_server": "https://api.quantumatlas.xyz/.well-known/oauth-authorization-server",
    "llms_summary": "https://shorekeyocmd.com/llms.txt",
    "browser": "https://shorekeyocmd.com/",
    "use": "Read the current manifest, invoke Shorekey directly over Streamable HTTP MCP (/mcp) or A2A JSON-RPC (/a2a), or bootstrap via Quantum Atlas /agents/connect. Public reads and stay quotes require no account and create no reservation or hold. Partner and property-owner agents manage scoped bearer, OAuth 2.0, and Microsoft Entra grants at https://api.quantumatlas.xyz/agents/connections."
  },
  "observation": {
    "observed_at": "2026-10-22T04:55:44.353Z",
    "refresh_after": "2026-10-22T04:57:44.353Z",
    "listed_homes_count": 1,
    "published_venue_offers_count": 0,
    "arrival_confirmed": false,
    "payment_state": "not_started"
  },
  "public_reads": [
    {
      "name": "stays.houses.list",
      "method": "GET",
      "url": "https://shorekeyocmd.com/shorekey/api/public/houses",
      "authentication": "none",
      "query": {
        "site": "optional: published company site_slug",
        "check_in": "optional: YYYY-MM-DD",
        "check_out": "optional: YYYY-MM-DD, after check_in",
        "guests": "optional: integer 1..50"
      },
      "use": "List published Ocean City vacation homes with $0 Shorekey guest booking fee. Supplying check_in and check_out filters to available homes with calculated stay totals."
    },
    {
      "name": "stays.house.detail",
      "method": "GET",
      "url": "https://shorekeyocmd.com/shorekey/api/public/houses/{property_id}",
      "authentication": "none",
      "use": "Read property details, bedrooms, max guests, seasonal rules, cancellation terms, payment schedule, and verified reviews. Street address and arrival instructions remain locked until a booking is confirmed, paid, and within the authorized arrival window."
    },
    {
      "name": "stays.house.unavailable",
      "method": "GET",
      "url": "https://shorekeyocmd.com/shorekey/api/public/houses/{property_id}/unavailable",
      "authentication": "none",
      "query": {
        "from": "required: YYYY-MM-DD",
        "to": "required: YYYY-MM-DD, up to 400 days after from"
      },
      "use": "Read unavailable nights combining direct Shorekey reservations and 15-minute two-way iCal sync."
    },
    {
      "name": "mobility.corridor.availability",
      "method": "GET",
      "url": "https://shorekeyocmd.com/shorekey/api/public/corridor-availability",
      "authentication": "none",
      "query": {
        "street": "required: integer 0..146 (0 = Downtown / Inlet)",
        "from": "optional: YYYY-MM-DD",
        "to": "optional: YYYY-MM-DD",
        "nights": "optional: integer 1..28 (default 7)",
        "guests": "optional: integer 1..50 (default 2)"
      },
      "use": "Search available stays by Ocean City street corridor and side (Oceanside, Bayside, West Ocean City, Ocean Pines) with per-person split estimates. Respect booking_recheck_required."
    },
    {
      "name": "concierge.spotlights.list",
      "method": "GET",
      "url": "https://shorekeyocmd.com/shorekey/api/public/spotlights",
      "authentication": "none",
      "query": {
        "zone": "optional: boardwalk | midtown | north | west_oc | ocean_pines",
        "channel": "optional: in_home_concierge | bay_boat | tabletop_vip | plane | truck"
      },
      "use": "Read active, partner-approved local venue VIP dining and experience offers. Demo offers confer no redeemable benefit."
    },
    {
      "name": "destination.pulse.read",
      "method": "GET",
      "url": "https://shorekeyocmd.com/shorekey/api/public/discovery/pulse",
      "authentication": "none",
      "use": "Read live Ocean City beach day score, NOAA tide phase and water temperature, and boardwalk/inlet/bay camera scene telemetry."
    },
    {
      "name": "destination.highlights.read",
      "method": "GET",
      "url": "https://shorekeyocmd.com/shorekey/api/public/discovery/highlights",
      "authentication": "none",
      "query": {
        "zone": "optional: boardwalk | midtown | north | west_oc | ocean_pines"
      },
      "use": "Read curated Ocean City landmark and neighborhood media."
    }
  ],
  "estimates": [
    {
      "name": "stays.house.quote",
      "method": "GET",
      "url": "https://shorekeyocmd.com/shorekey/api/public/houses/{property_id}/quote",
      "authentication": "none",
      "query": {
        "check_in": "required: YYYY-MM-DD",
        "check_out": "required: YYYY-MM-DD, after check_in",
        "guests": "optional: integer 1..50"
      },
      "side_effects": "none",
      "result": "Itemized stay quote with $0 Shorekey guest booking fee, cleaning fee, configured lodging taxes, free-cancellation cutoff, deposit schedule, and suggested alternative dates when unavailable. Creates no hold, reservation, or payment."
    }
  ],
  "handoffs": {
    "guest_direct_checkout": {
      "url_template": "https://shorekeyocmd.com/stays/{property_id}?check_in={check_in}&check_out={check_out}&guests={guests}",
      "mode": "human_browser_handoff",
      "required_before_booking": [
        "verify_dates_and_guests",
        "accept_rental_terms",
        "verify_cancellation_policy",
        "person_payment_authorization"
      ],
      "completion_evidence": "confirmed_booking_reference"
    },
    "guest_overflow_stay_request": {
      "url": "https://shorekeyocmd.com/stay-request",
      "mode": "human_browser_handoff",
      "use": "When preferred dates or homes are unavailable, hand off to the Stay Request desk so local property managers and founding partners can reply with direct offers."
    },
    "partner_and_owner_onboarding": {
      "url": "https://shorekeyocmd.com/onboard",
      "referral_url_template": "https://shorekeyocmd.com/onboard?ref={referral_code}",
      "brochure_url": "https://shorekeyocmd.com/partner-brochure",
      "mode": "human_browser_handoff",
      "use": "Property owners and local venues onboard here. Founding partner agents (Muse, OpenAI Agents, Claude, Grok) must preserve the partner referral_code in ?ref= so booking split attribution is recorded."
    },
    "partner_agent_delegation": {
      "url": "https://api.quantumatlas.xyz/agents/connections",
      "oauth_metadata": "https://api.quantumatlas.xyz/.well-known/oauth-authorization-server",
      "mode": "human_authenticated_grant",
      "use": "Property owners and founding partners issue, rotate, or revoke scoped bearer, OAuth 2.0, or Microsoft Entra grants for their personal agents."
    }
  },
  "request_policy": {
    "follow_up": "Read only when relevant to the user stay, local venue offer, or partner onboarding task; honor Cache-Control, Retry-After, and quote freshness.",
    "authority": "Public data, stay quotes, and QR links do not grant booking confirmation, property address unlock, or payment execution. Arrival details unlock only for confirmed, paid bookings during the active stay window.",
    "identity": "Never send private keys, session cookies, or upstream API credentials to public endpoints. Manage delegated partner agent credentials exclusively at https://api.quantumatlas.xyz/agents/connections."
  }
}