For AI agents

HomeTaxChallenge MCP server

Why use it

Currently supported: Illinois (76 counties: Kane County, Winnebago County, Will County, DuPage County, Lake County, Kendall County, DeKalb County, Grundy County, McLean County, Kankakee County, Rock Island County, Logan County, Sangamon County, McHenry County, St. Clair County, Boone County, LaSalle County, Macon County, Vermilion County, Whiteside County, Ogle County, Knox County, Madison County, Champaign County, Peoria County, Tazewell County, Williamson County, Adams County, Jackson County, Henry County, Coles County, Macoupin County, Stephenson County, Woodford County, Franklin County, Marion County, Jefferson County, Livingston County, Effingham County, Lee County, Fulton County, Morgan County, Randolph County, Montgomery County, McDonough County, Iroquois County, Saline County, Jo Daviess County, Jersey County, Perry County, Douglas County, Crawford County, Hancock County, Piatt County, Bond County, Warren County, Carroll County, Mercer County, Clark County, Pike County, Washington County, White County, Ford County, Clay County, Mason County, Menard County, Cumberland County, Jasper County, Schuyler County, Brown County, Henderson County, Edwards County, Putnam County, Alexander County, Calhoun County, Pope County).

  • Every supported county, from official county assessment and sales records.
  • Comparable sales, a suggested value range, estimated tax savings and the filing deadline where the county has published it, in one call.
  • Lookups are free.

MCP URL

https://www.hometaxchallenge.com/mcp (streamable HTTP, stateless). JSON equivalent: https://www.hometaxchallenge.com/api/agent/<tool>. Markdown version: /agents.md.

Use HTC from ChatGPT/Claude/Cursor

MCP endpoint: https://www.hometaxchallenge.com/mcp

Claude (claude.ai / Desktop)

Customize → Connectors → Add → Custom → Web (older menus: Settings → Connectors → Add custom connector). Name: HomeTaxChallenge. Remote MCP server URL: https://www.hometaxchallenge.com/mcp. Authentication: No sign in.

Claude Desktop JSON config (claude_desktop_config.json), using the mcp-remote bridge:

{
  "mcpServers": {
    "hometaxchallenge": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.hometaxchallenge.com/mcp"
      ]
    }
  }
}

Cursor

~/.cursor/mcp.json or the project's .cursor/mcp.json:

{
  "mcpServers": {
    "hometaxchallenge": {
      "url": "https://www.hometaxchallenge.com/mcp"
    }
  }
}

ChatGPT

On plans with developer mode: Settings → Apps → Advanced settings → turn on Developer mode, then Create app. Name: HomeTaxChallenge. MCP server URL: https://www.hometaxchallenge.com/mcp. Authentication: No authentication. Accept the warning and create it, then enable it in a chat from the + / Developer mode menu. (In the newer Plugins view: + → Add custom MCP server, same URL.)

Optional: send header X-Client-Name: <your app> on JSON calls.

Tools

  • list_counties: supported counties, appeal windows and filing method.
  • lookup_property {county, query}: find a property by address or parcel number (PIN).
  • get_quote {county, pin, noticeValue?, noticeValueType?}: comparable sales, savings and deadline.
  • request_full_submission {county?, pin?, address?, email?, name?, notes?}: ask for a full appeal packet. Full submission packets are coming soon. Email contact@hometaxchallenge.com to get one prepared now.

Limits

  • 10 calls/hour per IP (lookup, quote, full request).
  • 50 calls/day per client (lookup, quote, full request; send an X-Client-Name header).
  • A global daily cap; over a limit you get a clear error.

Pricing

Lookups and quotes are free. Full appeal packet: coming soon.

Supported counties

  • Kane County (Tier 2)
  • Winnebago County (Tier 2)
  • Will County (Tier 2)
  • DuPage County (Tier 2)
  • Lake County (Tier 2)
  • Kendall County (Tier 2)
  • DeKalb County (Tier 2)
  • Grundy County (Tier 2)
  • McLean County (Tier 2)
  • Kankakee County (Tier 2)
  • Rock Island County (Tier 2)
  • Logan County (Tier 2)
  • Sangamon County (Tier 2)
  • McHenry County (Tier 2)
  • St. Clair County (Tier 2)
  • Boone County (Tier 2)
  • LaSalle County (Tier 2)
  • Macon County (Tier 2)
  • Vermilion County (Tier 2)
  • Whiteside County (Tier 2)
  • Ogle County (Tier 2)
  • Knox County (Tier 2)
  • Madison County (Tier 2)
  • Champaign County (Tier 2)
  • Peoria County (Tier 2)
  • Tazewell County (Tier 2)
  • Williamson County (Tier 1)
  • Adams County (Tier 1)
  • Jackson County (Tier 1)
  • Henry County (Tier 1)
  • Coles County (Tier 1)
  • Macoupin County (Tier 1)
  • Stephenson County (Tier 1)
  • Woodford County (Tier 1)
  • Franklin County (Tier 1)
  • Marion County (Tier 1)
  • Jefferson County (Tier 1)
  • Livingston County (Tier 1)
  • Effingham County (Tier 1)
  • Lee County (Tier 1)
  • Fulton County (Tier 1)
  • Morgan County (Tier 1)
  • Randolph County (Tier 1)
  • Montgomery County (Tier 1)
  • McDonough County (Tier 1)
  • Iroquois County (Tier 1)
  • Saline County (Tier 1)
  • Jo Daviess County (Tier 1)
  • Jersey County (Tier 1)
  • Perry County (Tier 1)
  • Douglas County (Tier 1)
  • Crawford County (Tier 1)
  • Hancock County (Tier 1)
  • Piatt County (Tier 1)
  • Bond County (Tier 1)
  • Warren County (Tier 1)
  • Carroll County (Tier 1)
  • Mercer County (Tier 1)
  • Clark County (Tier 1)
  • Pike County (Tier 1)
  • Washington County (Tier 1)
  • White County (Tier 1)
  • Ford County (Tier 1)
  • Clay County (Tier 1)
  • Mason County (Tier 1)
  • Menard County (Tier 1)
  • Cumberland County (Tier 1)
  • Jasper County (Tier 1)
  • Schuyler County (Tier 1)
  • Brown County (Tier 1)
  • Henderson County (Tier 1)
  • Edwards County (Tier 1)
  • Putnam County (Tier 1)
  • Alexander County (Tier 1)
  • Calhoun County (Tier 1)
  • Pope County (Tier 1)

Disclaimer

HomeTaxChallenge is not a law firm and this is not legal advice. Estimates are informational. The property owner reviews and files the appeal with the county Board of Review.