{
  "spec": {
    "scheme": "agent-presence",
    "name": "Agent Presence",
    "spec_version": "0.2",
    "bundle_schema_version": "0.1"
  },
  "business": {
    "id": "shades-creek-home-buyers",
    "name": "Shades Creek Home Buyers"
  },
  "canonical_url": "https://shadescreekhomebuyers.com/",
  "describes": "https://shadescreekhomebuyers.com/.well-known/business-capabilities.json",
  "mode": "request-only",
  "generated_at": "2026-09-02T00:01:40.105Z",
  "endpoint": {
    "url": "https://shadescreekhomebuyers.com/interactions/request",
    "method": "POST",
    "content_type": "application/json"
  },
  "authorization": {
    "scheme": "shared-key",
    "required": false,
    "applies_to": [],
    "how_to_obtain": "Authorization is granted by the business owner out of band. Unauthorized requests are refused and recorded.",
    "envelope_fields": [
      "agent_id",
      "agent_key",
      "interaction_id",
      "idempotency_key",
      "input"
    ],
    "open": {
      "interactions": [
        "check-we-buy-here",
        "request-a-conversation"
      ],
      "required": false,
      "how_to_obtain": "Nothing to obtain. Send the envelope without agent_key. Supply any stable agent_id so the request can be traced and deduplicated; it is recorded as unverified and is never treated as proof of identity.",
      "envelope_fields": [
        "agent_id",
        "interaction_id",
        "idempotency_key",
        "input"
      ],
      "cannot": "An open interaction is answered from published claims or queued for a person. It can never commit the business, and it grants no access to the proposal path."
    }
  },
  "qualification": {
    "claim_id": "claim:shades-creek-home-buyers:fit-criteria",
    "decided_by": "published_criteria",
    "accepts": [
      {
        "claim_id": "claim:schb:service:buy-direct",
        "label": "buy direct",
        "recognises": [
          "buys",
          "houses",
          "directly",
          "owners",
          "stand",
          "across",
          "metro"
        ]
      },
      {
        "claim_id": "claim:schb:service:itemised-offer",
        "label": "itemised offer",
        "recognises": [
          "delivers",
          "written",
          "itemised",
          "offer",
          "likely",
          "repaired",
          "list",
          "price",
          "repair",
          "cost",
          "carrying",
          "closing",
          "costs",
          "buyer"
        ]
      },
      {
        "claim_id": "claim:schb:service:probate",
        "label": "probate",
        "recognises": [
          "buys",
          "inherited",
          "probate",
          "property",
          "executor",
          "lives",
          "state"
        ]
      },
      {
        "claim_id": "claim:schb:service:foreclosure-liens",
        "label": "foreclosure liens",
        "recognises": [
          "buys",
          "foreclosure",
          "date",
          "liens",
          "back",
          "taxes",
          "repairs",
          "lender",
          "finance",
          "retail",
          "buyer",
          "through"
        ]
      },
      {
        "claim_id": "claim:schb:service:relocation",
        "label": "relocation",
        "recognises": [
          "buys",
          "move",
          "assisted",
          "living",
          "relocation",
          "change",
          "circumstances",
          "left",
          "house",
          "longer",
          "fitting"
        ]
      },
      {
        "claim_id": "claim:schb:service:occupied",
        "label": "occupied",
        "recognises": [
          "buys",
          "property",
          "occupied",
          "behind",
          "payments",
          "mid-dispute",
          "stands"
        ]
      },
      {
        "claim_id": "claim:schb:service:timeline",
        "label": "timeline",
        "recognises": [
          "closes",
          "seven",
          "days",
          "ninety",
          "seller",
          "needs",
          "somewhere",
          "first"
        ]
      }
    ],
    "declines": [],
    "geography": {
      "remote": false,
      "named_markets": [
        "Jefferson",
        "Shelby",
        "Alabama",
        "Clair",
        "Blount",
        "Walker",
        "Bibb",
        "Chilton",
        "Talladega",
        "Birmingham"
      ],
      "note": "Only the named markets are published."
    },
    "note": "These are the criteria the service_fit_check applies. An agent can evaluate them itself and never file a request."
  },
  "mcp": {
    "url": "https://shadescreekhomebuyers.com/mcp",
    "transport": "streamable-http",
    "protocol_version": "2025-06-18",
    "tools": [
      {
        "name": "check_fit",
        "interaction_id": "check-we-buy-here",
        "authorization": "open"
      },
      {
        "name": "request_consultation",
        "interaction_id": "request-a-conversation",
        "authorization": "open"
      }
    ],
    "note": "The same interactions as the HTTP endpoint above, on the same terms. Nothing callable here is unavailable there, and nothing here can commit the business."
  },
  "idempotency": {
    "required": true,
    "field": "idempotency_key",
    "scope": "per agent",
    "behavior": "Replaying a key with the same body returns the original receipt. Reusing it with a different body is refused."
  },
  "interactions": [
    {
      "id": "check-we-buy-here",
      "kind": "service_fit_check",
      "capability_id": "describe-coverage",
      "capability_name": "Name the counties covered",
      "authorization": "open",
      "answered": "immediately, from published claims",
      "input_schema": {
        "need": {
          "type": "string",
          "required": true,
          "max_length": 500
        },
        "location": {
          "type": "string",
          "required": false,
          "max_length": 200
        }
      }
    },
    {
      "id": "request-a-conversation",
      "kind": "consultation_request",
      "capability_id": "find-contact",
      "capability_name": "Find how to reach the business",
      "authorization": "open",
      "answered": "by a human, after review",
      "input_schema": {
        "name": {
          "type": "string",
          "required": true,
          "max_length": 200
        },
        "contact": {
          "type": "string",
          "required": true,
          "max_length": 300
        },
        "topic": {
          "type": "string",
          "required": true,
          "max_length": 1000
        },
        "preferred_times": {
          "type": "string",
          "required": false,
          "max_length": 500
        }
      }
    }
  ],
  "receipts": {
    "issued_for": "every accepted request",
    "fields": [
      "receipt_id",
      "kind",
      "request_hash",
      "received_at",
      "source_revision",
      "status"
    ],
    "statuses": [
      "answered_from_published_claims",
      "queued_for_human",
      "answered_by_human"
    ],
    "read": {
      "url": "https://shadescreekhomebuyers.com/interactions/requests/{receipt_id}",
      "method": "GET",
      "parameters": {
        "agent_id": "the agent_id that filed the request"
      },
      "authorization": "The receipt_id, which is unguessable, together with the agent_id that filed it. Holding the receipt is the only proof the open tier has; it identifies a request, not an agent, and grants nothing else.",
      "covers": "requests queued for a person. A request answered from published claims carried its answer in the original response and is not stored to be re-read.",
      "returns": "the request's status, and once a person has answered it, their answer and when they gave it. The input you sent is never echoed back.",
      "polling": "Check back rather than filing again. A second request under a new idempotency_key is a second person to answer, not a reminder."
    },
    "reply": {
      "url": "https://shadescreekhomebuyers.com/interactions/requests/{receipt_id}/reply",
      "method": "POST",
      "envelope_fields": [
        "agent_id",
        "idempotency_key",
        "reply"
      ],
      "authorization": "The same as the readback: the receipt_id together with the agent_id that filed it. It grants nothing further.",
      "effect": "Appends your message to the same request and queues the person who answered it. It never creates a second request, and it can never commit the business.",
      "limits": "At most 6 replies per request, 2000 characters each. Replaying an idempotency_key returns the same state instead of sending the message twice."
    }
  },
  "will_never": [
    "negotiate price or terms",
    "issue a quote or an invoice",
    "confirm availability, stock, or a schedule",
    "accept payment or payment details",
    "create a binding commitment of any kind",
    "send communication on the business's behalf"
  ],
  "will_never_scope": "the interaction endpoint at https://shadescreekhomebuyers.com/interactions/request",
  "refusals": {
    "documented": true,
    "codes": [
      "UNAUTHORIZED",
      "AGENT_REVOKED",
      "UNKNOWN_INTERACTION",
      "INTERACTION_REVOKED",
      "BAD_IDEMPOTENCY_KEY",
      "IDEMPOTENCY_CONFLICT",
      "INVALID_INPUT",
      "BAD_ENVELOPE"
    ],
    "note": "Every refusal is recorded in the business's audit trail with the requesting agent id."
  },
  "scheme": "agent-presence",
  "spec_version": "0.2"
}