{
  "name": "Texas Homebuyer Money Finder",
  "version": "1.0.0",
  "description": "Structured decision support that helps prospective Texas homebuyers identify POSSIBLE homebuyer-assistance program matches — grants, down-payment assistance, closing-cost help, and homebuyer-education pathways — with what each program may offer, why it appeared as a possible match, items to verify, and official source links.",
  "provider": {
    "name": "Texas Homebuyer Money Finder",
    "url": "https://homemoneyfinder.com",
    "documentation": "https://homemoneyfinder.com/decision-tools"
  },
  "canonicalEngine": {
    "description": "Every access channel below calls one canonical matching engine, so results are consistent regardless of how an agent connects.",
    "endpoint": "https://homemoneyfinder.com/api/v1/match",
    "method": "POST"
  },
  "accessChannels": [
    {
      "type": "rest_api",
      "name": "REST API",
      "endpoint": "https://homemoneyfinder.com/api/v1/match",
      "method": "POST",
      "authentication": "none",
      "description": "Plain HTTP JSON endpoint. Send { \"answers\": { ... } } and receive possible matches with what each offers, why matched, verification items, and official links."
    },
    {
      "type": "openapi",
      "name": "OpenAPI specification",
      "endpoint": "https://homemoneyfinder.com/openapi.json",
      "documentation": "https://homemoneyfinder.com/docs",
      "description": "OpenAPI 3.0 description of all public endpoints, with interactive reference docs."
    },
    {
      "type": "remote_mcp",
      "name": "Remote MCP server",
      "endpoint": "https://homemoneyfinder.com/api/webmcp",
      "protocol": "Model Context Protocol (JSON-RPC 2.0)",
      "protocolVersion": "2025-06-18",
      "discovery": [
        "https://homemoneyfinder.com/.well-known/mcp.json",
        "https://homemoneyfinder.com/.well-known/mcp/server-card.json"
      ],
      "methods": ["initialize", "tools/list", "tools/call"],
      "description": "GET returns the tool descriptor; POST accepts JSON-RPC 2.0 requests."
    },
    {
      "type": "browser_webmcp",
      "name": "In-browser WebMCP tool",
      "registeredOn": "https://homemoneyfinder.com/decision-tools",
      "registrationApi": "document.modelContext.registerTool()",
      "description": "When a compatible agent browser opens the decision-tools page, the find_homebuyer_options tool is registered automatically for in-page invocation."
    }
  ],
  "tools": [
    {
      "name": "find_homebuyer_options",
      "description": "Run the assessment for a prospective buyer and return possible homebuyer-assistance program matches. Available via REST, remote MCP, and in-browser WebMCP.",
      "input": [
        "city", "county", "householdSize", "incomeRange", "firstTimeBuyer", "needDownPayment",
        "veteranStatus", "occupation", "ruralOpen", "creditRange", "priceRange", "completedEducation"
      ],
      "output": [
        "programId", "programName", "matchCategory", "whyMatched", "whatOffered",
        "verifyChecklist", "nextStep", "officialUrl", "applicationUrl", "lastVerified"
      ]
    },
    {
      "name": "list_programs",
      "description": "Browse or filter the Texas homebuyer-assistance program library.",
      "endpoint": "https://homemoneyfinder.com/api/v1/programs"
    },
    {
      "name": "get_program",
      "description": "Retrieve a single program by its program ID.",
      "endpoint": "https://homemoneyfinder.com/api/v1/programs/{id}"
    }
  ],
  "analytics": {
    "endpoint": "https://homemoneyfinder.com/api/v1/analytics",
    "description": "Aggregate-only counts of agent-access usage. No personal data is recorded or exposed."
  },
  "safety": {
    "resultType": "possible_matches_only",
    "guarantees": "none",
    "boundaries": [
      "Returns possible matches only — never a qualification, eligibility, or approval decision.",
      "Does not pull credit and does not require a Social Security number.",
      "Does not guarantee funding, assistance, or lender approval.",
      "Does not provide legal or financial advice.",
      "Directs users to official program sources for final verification."
    ],
    "disclaimer": "This is an educational decision-support tool. Program rules, income limits, and funding availability change — always verify with the official source, approved lender, housing counselor, or program administrator."
  }
}