{
    "$comment": "MCP server discovery card. Tracks the emerging SEP-1960 spec (Model Context Protocol auto-discovery, January 2026 — Anthropic + OpenAI joint extension). Lets MCP-aware clients (Claude Desktop, ChatGPT, Cursor, future agentic AI assistants) auto-discover the BC Real Estate Codex MCP server when a user visits bronsonjob.com. Update on every MCP package release.",
    "schema_version": "sep-1960-draft-1",
    "name": "bc-real-estate-codex",
    "display_name": "BC Real Estate Codex",
    "description": "Authoritative British Columbia residential real estate facts — property transfer tax, foreign-buyer rules, flipping tax, CMHC + OSFI mortgage rules, designated agency, strata Bill 44, SSMUH, STRAA short-term rentals — verified quarterly against primary government sources. 48 facts, CC BY 4.0, SHA-256 content digest on every deploy (Ed25519 signing provisioned, not yet active).",
    "version": "0.1.0",
    "homepage": "https://www.bronsonjob.com/codex/api",
    "publisher": {
        "name": "Bronson Job PREC",
        "url": "https://www.bronsonjob.com/about/bronson-job",
        "email": "bronson@bronsonjob.com",
        "legal_name": "Bronson Job Personal Real Estate Corporation"
    },
    "license": "MIT",
    "data_license": "CC BY 4.0",
    "data_license_url": "https://creativecommons.org/licenses/by/4.0/",
    "repository": "https://github.com/bronson-job-realestate/bronson-job-vow",
    "transports": [
        {
            "type": "stdio",
            "package": "@bronsonjob/mcp-bc-real-estate",
            "binary": "mcp-bc-real-estate",
            "install_hint": "npm install -g @bronsonjob/mcp-bc-real-estate",
            "config_example": {
                "mcpServers": {
                    "bc-real-estate-codex": {
                        "command": "npx",
                        "args": ["-y", "@bronsonjob/mcp-bc-real-estate"]
                    }
                }
            }
        }
    ],
    "tools": [
        {
            "name": "get_fact",
            "description": "Retrieve a single BC real estate fact by ID (e.g. bc.ptt.brackets, bc.ptt.foreign_buyer_additional). Returns canonical value, effective/expires/retrieved dates, primary-source citations."
        },
        {
            "name": "list_facts",
            "description": "List all available facts, optionally filtered by domain (tax, mortgage, legal, foreign-buyer, strata, rental)."
        },
        {
            "name": "calculate_property_transfer_tax",
            "description": "Compute BC Property Transfer Tax for a purchase price, with optional first-time-buyer / newly-built / foreign-buyer adjustments."
        },
        {
            "name": "calculate_mortgage_payment",
            "description": "Calculate monthly mortgage payment using BC-typical compounding (semi-annual, not in advance) per Interest Act of Canada s.6."
        },
        {
            "name": "calculate_investment_metrics",
            "description": "Cap rate, NOI, DSCR (debt-service coverage ratio), monthly P&I, and annual cash flow for an investment property."
        },
        {
            "name": "check_foreign_buyer_eligibility",
            "description": "Determine whether a buyer is subject to federal Prohibition on the Purchase of Residential Property by Non-Canadians Act and/or BC's additional 20% PTT for foreign buyers."
        },
        {
            "name": "get_codex_reference_url",
            "description": "Get the canonical /codex URL where a fact's full provenance (effective date, primary-source citations, version history) is publicly displayed."
        }
    ],
    "fallback_endpoints": {
        "$comment": "Pre-MCP HTTP fallback for clients that don't yet speak MCP — same data, plain JSON. Production today. These remain the canonical citation URLs.",
        "catalog": "https://www.bronsonjob.com/api/v1/facts/index.json",
        "by_id": "https://www.bronsonjob.com/api/v1/facts/by-id/{factId}.json",
        "domain_bundle": "https://www.bronsonjob.com/api/v1/facts/{domain}.json",
        "diff_index": "https://www.bronsonjob.com/api/v1/facts/diff/index.json",
        "rss_feed": "https://www.bronsonjob.com/api/v1/facts/feed.xml",
        "llms_compact": "https://www.bronsonjob.com/api/v1/facts/llms.json",
        "manifest": "https://www.bronsonjob.com/api/v1/facts/manifest.json",
        "openapi": "https://www.bronsonjob.com/.well-known/openapi.json",
        "signature_attestation": "https://www.bronsonjob.com/.well-known/codex-signature.json",
        "public_keys": "https://www.bronsonjob.com/.well-known/keys.json"
    },
    "auth": {
        "type": "none",
        "rate_limit": "Public; no key required. Be reasonable; non-malicious anonymous usage is welcomed."
    },
    "provenance": {
        "$comment": "Every Codex deploy carries a SHA-256 digest of the canonical Fact Bank snapshot at attestation_url, so any consumer can recompute the digest of /api/v1/facts/index.json and verify byte-for-byte integrity. Ed25519 cryptographic signing is provisioned in the pipeline but NOT YET ACTIVE — no signing keypair has been registered. public_key_url currently reports status: 'no_keys_provisioned'. Once a keypair is registered, signatures will be emitted automatically and this field flips to active without spec change.",
        "digest_algorithm": "SHA-256",
        "signature_algorithm": "Ed25519",
        "signature_status": "provisioned_inactive",
        "public_key_url": "https://www.bronsonjob.com/.well-known/keys.json",
        "attestation_url": "https://www.bronsonjob.com/.well-known/codex-signature.json"
    }
}
