Sparks RE API — Real Estate & FHA Compliance Agent

{
  "protocolVersion": "1.0",
  "name": "Sparks RE API \u2014 Real Estate & FHA Compliance Agent",
  "description": "Autonomous real estate data extraction, Fair Housing Act (FHA) compliance scanning across all 7 federal protected classes, and rental property investment underwriting (Cap Rate, DSCR, Cash-on-Cash, NOI). Supports x402 USDC micropayments on Base Mainnet and Model Context Protocol (MCP).",
  "url": "https://sparks-re-api.sparksdigital-re.workers.dev",
  "version": "1.0.0",
  "provider": {
    "organization": "Sparks Digital LLC",
    "url": "https://sparks-re-api.sparksdigital-re.workers.dev"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "authentication": {
    "schemes": [
      "x402",
      "none"
    ],
    "credentials": "Stateless HTTP 402 Payment Required via x402 protocol (USDC on Base Mainnet eip155:8453) or direct MCP tool invocation at /mcp."
  },
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "normalize-property",
      "name": "Property Data Normalizer",
      "description": "Extract structured property fields (address, city, state, zip, beds, baths, sqft, lot_size, year_built, property_type, raw_price) from unstructured real estate text ($0.03 USDC).",
      "tags": [
        "real-estate",
        "parser",
        "mls",
        "normalization",
        "x402"
      ],
      "examples": [
        "Parse 3bd 2ba at 789 Maple Ave, Indianapolis, IN 46220 for $295,000"
      ]
    },
    {
      "id": "check-fha-compliance",
      "name": "Fair Housing Act (FHA) Compliance Scanner",
      "description": "Scan property marketing copy against 50+ discriminatory patterns across all 7 federal protected classes (Race, Color, Religion, National Origin, Sex, Familial Status, Disability) and generate a compliant rewrite ($0.05 USDC).",
      "tags": [
        "real-estate",
        "compliance",
        "fha",
        "fair-housing",
        "legal-tech",
        "x402"
      ],
      "examples": [
        "Scan this listing description for Fair Housing Act violations"
      ]
    },
    {
      "id": "calculate-investor-metrics",
      "name": "Real Estate Investment Underwriting Calculator",
      "description": "Compute Cap Rate, Cash-on-Cash Return, DSCR, Gross Rent Multiplier, Monthly Cashflow, and Annual NOI from purchase price, monthly rent, and down payment ($0.10 USDC).",
      "tags": [
        "real-estate",
        "underwriting",
        "finance",
        "cap-rate",
        "dscr",
        "x402"
      ],
      "examples": [
        "Calculate DSCR and Cap Rate for a $250,000 property renting at $2,000/month with 20% down"
      ]
    },
    {
      "id": "analyze-property-text",
      "name": "Consolidated AI + Rule-Based Property Text Analyzer",
      "description": "Submit raw property text or MLS copy to extract specs, scan for FHA compliance violations across all 7 protected classes, and compute investor returns in one report ($0.05 USDC).",
      "tags": [
        "real-estate",
        "nlp",
        "fha",
        "underwriting",
        "x402"
      ],
      "examples": [
        "Analyze this raw MLS description for FHA compliance and investor cashflow"
      ]
    },
    {
      "id": "analyze-property-url",
      "name": "Live Property Listing URL Scraper & Analyzer",
      "description": "Scrape a public real estate listing URL, extract property specs, run FHA compliance scanning, and calculate investor metrics in one consolidated report ($0.05 USDC).",
      "tags": [
        "real-estate",
        "scraper",
        "fha",
        "underwriting",
        "x402"
      ],
      "examples": [
        "Scrape and analyze https://mypropertylisting.com/123-main"
      ]
    },
    {
      "id": "analyze-property-image",
      "name": "Multimodal Property Screenshot Analyzer",
      "description": "Upload a base64 screenshot of a property listing for multimodal vision extraction, FHA compliance scanning, and investor underwriting metrics ($0.15 USDC).",
      "tags": [
        "real-estate",
        "multimodal",
        "vision",
        "fha",
        "underwriting",
        "x402"
      ],
      "examples": [
        "Analyze this listing screenshot for FHA compliance and cap rate"
      ]
    }
  ],
  "extensions": {
    "x402": {
      "network": "eip155:8453",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "token": "USDC",
      "facilitatorUrl": "https://facilitator.payai.network",
      "payTo": "0x8966A2aAe40e008f1f52962683Cb5D22aa700fb7"
    },
    "mcp": {
      "transport": "streamable-http",
      "url": "https://sparks-re-api.sparksdigital-re.workers.dev/mcp"
    }
  }
}