# Carfinity for AI agents

Carfinity is a car marketplace built for AI agents and the shoppers they work for. It lists new and used cars at local US dealers and ranks every car against its local market: market price, percent under or over market, a deal label, a 0 to 100 score and a rank among comparable cars.

## Fastest way: the MCP server

- Endpoint: https://carfinity.ai/mcp (Model Context Protocol, streamable HTTP, no key needed)
- Server card: https://carfinity.ai/.well-known/mcp/server-card.json
- Tools: search_cars, get_car, compare_cars, market_summary, dealer_info, list_markets, start_inquiry
- Limits: 10 cars per call, 10 pages per search, a daily allowance per connection

Typical flow: list_markets if the shopper's city is unknown, search_cars with their words, get_car on the ones they like, compare_cars, then give the car's Carfinity link so they can see the ranking, and offer start_inquiry.

## Reading pages directly

Every page is plain HTML with schema.org data. Car, market and search pages also have a Markdown version: add .md in place of the trailing slash, or send Accept: text/markdown.

- A car: https://carfinity.ai/car/<year-make-model-trim>-<id>/ (Markdown: the same path ending .md)
- A new model in a market: https://carfinity.ai/new/<make-model>/<market>/
- A used model in a market: https://carfinity.ai/used/<make-model>/<market>/
- A search in a market: https://carfinity.ai/find/<market>/<search>/ (for example https://carfinity.ai/find/dallas-tx/used-suv-under-30k/)
- A dealer: https://carfinity.ai/dealers/<state>/<dealer>/
- Search in plain language: https://carfinity.ai/search/?q=used+suv+under+30k+in+dallas
- Everything listed: https://carfinity.ai/llms.txt and https://carfinity.ai/sitemap-index.xml

Markets: New York (new-york-ny), Los Angeles (los-angeles-ca), Chicago (chicago-il), Dallas (dallas-tx), Houston (houston-tx), Washington (washington-dc), Philadelphia (philadelphia-pa), Atlanta (atlanta-ga), Miami (miami-fl), Phoenix (phoenix-az), Boston (boston-ma), Riverside (riverside-ca), San Francisco (san-francisco-ca), Detroit (detroit-mi), Seattle (seattle-wa), Minneapolis (minneapolis-mn), Tampa (tampa-fl), San Diego (san-diego-ca), Denver (denver-co), Baltimore (baltimore-md), St. Louis (st-louis-mo), Orlando (orlando-fl), Charlotte (charlotte-nc), San Antonio (san-antonio-tx), Portland (portland-or), Austin (austin-tx), Sacramento (sacramento-ca), Pittsburgh (pittsburgh-pa), Las Vegas (las-vegas-nv), Cincinnati (cincinnati-oh), Kansas City (kansas-city-mo), Columbus (columbus-oh), Indianapolis (indianapolis-in), Nashville (nashville-tn), Cleveland (cleveland-oh), San Jose (san-jose-ca), Virginia Beach (virginia-beach-va), Jacksonville (jacksonville-fl), Providence (providence-ri), Raleigh (raleigh-nc), Milwaukee (milwaukee-wi), Oklahoma City (oklahoma-city-ok), Louisville (louisville-ky), Memphis (memphis-tn), Salt Lake City (salt-lake-city-ut), Richmond (richmond-va), Birmingham (birmingham-al), Fresno (fresno-ca), Grand Rapids (grand-rapids-mi), Buffalo (buffalo-ny), Hartford (hartford-ct), Tucson (tucson-az), Tulsa (tulsa-ok), Honolulu (honolulu-hi), Omaha (omaha-ne), Rochester (rochester-ny), New Haven (new-haven-ct), Poughkeepsie (poughkeepsie-ny), Greenville (greenville-sc), Albuquerque (albuquerque-nm), Bakersfield (bakersfield-ca), Albany (albany-ny), Knoxville (knoxville-tn), New Orleans (new-orleans-la), McAllen (mcallen-tx), Baton Rouge (baton-rouge-la), El Paso (el-paso-tx), Allentown (allentown-pa), Oxnard (oxnard-ca), Columbia (columbia-sc), Sarasota (sarasota-fl), Dayton (dayton-oh), Charleston (charleston-sc), Greensboro (greensboro-nc), Fort Myers (fort-myers-fl), Stockton (stockton-ca), Boise (boise-id), Colorado Springs (colorado-springs-co), Little Rock (little-rock-ar), Lakeland (lakeland-fl), Akron (akron-oh), Des Moines (des-moines-ia), Ogden (ogden-ut), Madison (madison-wi), Daytona Beach (daytona-beach-fl), Syracuse (syracuse-ny), Wichita (wichita-ks), Toledo (toledo-oh), Augusta (augusta-ga), Melbourne (melbourne-fl), Jackson (jackson-ms), Harrisburg (harrisburg-pa), Spokane (spokane-wa), Scranton (scranton-pa), Chattanooga (chattanooga-tn), Portland (portland-me), Fayetteville (fayetteville-ar), Lansing (lansing-mi), Youngstown (youngstown-oh), Lexington (lexington-ky), Fayetteville (fayetteville-nc), Pensacola (pensacola-fl), Reno (reno-nv), Huntsville (huntsville-al), Lafayette (lafayette-la), Myrtle Beach (myrtle-beach-sc), Springfield (springfield-mo), Killeen (killeen-tx), Asheville (asheville-nc), Salinas (salinas-ca), Salem (salem-or), Mobile (mobile-al), Corpus Christi (corpus-christi-tx), Manchester (manchester-nh), Fort Wayne (fort-wayne-in), Gulfport (gulfport-ms), Salisbury (salisbury-md), Flint (flint-mi), Peoria (peoria-il), Savannah (savannah-ga), Anchorage (anchorage-ak), Beaumont (beaumont-tx), Shreveport (shreveport-la), Montgomery (montgomery-al), Davenport (davenport-ia), Tallahassee (tallahassee-fl), Eugene (eugene-or), Ocala (ocala-fl), Hickory (hickory-nc), Huntington (huntington-wv), Fort Collins (fort-collins-co), Rockford (rockford-il), Lincoln (lincoln-ne), Green Bay (green-bay-wi), Columbus (columbus-ga), South Bend (south-bend-in), Lubbock (lubbock-tx), Clarksville (clarksville-tn), Roanoke (roanoke-va), Evansville (evansville-in), Kingsport (kingsport-tn), Kennewick (kennewick-wa), Utica (utica-ny), Hagerstown (hagerstown-md), Olympia (olympia-wa), Longview (longview-tx), Wilmington (wilmington-nc), San Luis Obispo (san-luis-obispo-ca), Waco (waco-tx), Cedar Rapids (cedar-rapids-ia), Atlantic City (atlantic-city-nj), Sioux Falls (sioux-falls-sd), Erie (erie-pa), Amarillo (amarillo-tx), College Station (college-station-tx), Kalamazoo (kalamazoo-mi), Lynchburg (lynchburg-va), Charleston (charleston-wv), Fargo (fargo-nd), Binghamton (binghamton-ny), Fort Smith (fort-smith-ar), Topeka (topeka-ks), Macon (macon-ga), Hyannis (hyannis-ma), Bellingham (bellingham-wa), Burlington (burlington-vt), Rochester (rochester-mn), Lafayette (lafayette-in), Champaign (champaign-il), Lake Charles (lake-charles-la), Las Cruces (las-cruces-nm), Athens (athens-ga), Columbia (columbia-mo), Springfield (springfield-il), Monroe (monroe-la), Jacksonville (jacksonville-nc), Florence (florence-sc), St. Cloud (st-cloud-mn), Saginaw (saginaw-mi), Terre Haute (terre-haute-in), Billings (billings-mt), Joplin (joplin-mo), Dover (dover-de), Jackson (jackson-tn), Abilene (abilene-tx), Bowling Green (bowling-green-ky), Midland (midland-tx), Eau Claire (eau-claire-wi), Greenville (greenville-nc), Coeur d'Alene (coeur-dalene-id), Waterloo (waterloo-ia), Tupelo (tupelo-ms), Hattiesburg (hattiesburg-ms), Wausau (wausau-wi), Rapid City (rapid-city-sd), Bismarck (bismarck-nd), Santa Fe (santa-fe-nm), Idaho Falls (idaho-falls-id), Bangor (bangor-me), Morgantown (morgantown-wv), Dothan (dothan-al), Albany (albany-ga), Traverse City (traverse-city-mi), Wichita Falls (wichita-falls-tx), Texarkana (texarkana-tx), Jonesboro (jonesboro-ar), Dubuque (dubuque-ia), La Crosse (la-crosse-wi), Charlottesville (charlottesville-va), State College (state-college-pa), Williamsport (williamsport-pa), Johnstown (johnstown-pa), Elmira (elmira-ny), Watertown (watertown-ny), Rutland (rutland-vt), Parkersburg (parkersburg-wv), Beckley (beckley-wv), Meridian (meridian-ms), Alexandria (alexandria-la), Florence (florence-al), Carbondale (carbondale-il), Quincy (quincy-il), Lima (lima-oh), Mansfield (mansfield-oh), Wheeling (wheeling-wv), Winchester (winchester-va), Fredericksburg (fredericksburg-va), Brunswick (brunswick-ga), Rome (rome-ga), Sebring (sebring-fl), Grand Island (grand-island-ne), Enid (enid-ok), Ardmore (ardmore-ok), Hot Springs (hot-springs-ar), Columbus (columbus-ms), Greenville (greenville-ms), Anniston (anniston-al), Cookeville (cookeville-tn), Somerset (somerset-ky), Augusta (augusta-me), Montpelier (montpelier-vt), Keene (keene-nh), Sheboygan (sheboygan-wi), Mason City (mason-city-ia), Fort Dodge (fort-dodge-ia), Rolla (rolla-mo), St. Joseph (st-joseph-mo), Glenwood Springs (glenwood-springs-co), Palm Springs (palm-springs-ca), Sherman (sherman-tx), Huntsville (huntsville-tx), Statesboro (statesboro-ga), Waycross (waycross-ga), Vero Beach (vero-beach-fl), Bloomington (bloomington-in), Ottawa (ottawa-il), Toms River (toms-river-nj), Cheyenne (cheyenne-wy), San Juan (san-juan-pr), Hagatna (hagatna-gu).
Every make and model with cars for sale is listed, new and used: https://carfinity.ai/new/ and https://carfinity.ai/used/. The current markets, with counts: the list_markets tool, or https://carfinity.ai/metros/.

## How to quote Carfinity

- Prices are the dealer's advertised price, before tax, title and registration. Say so.
- Give the deal label with its numbers: "Great deal, $4,598 (13.8%) under market, rank 1 of 16".
- Labels: Great deal is 7% or more under market, Good deal 3% to 7%, Fair price within 3%, otherwise Above market. Method: https://carfinity.ai/methodology/
- Include the data date and link the car's page.
- Never state a monthly payment Carfinity did not give, and never invent a car.

## Contacting a dealer for the shopper

start_inquiry prepares the message to the dealer (availability, out-the-door price with fees, add-ons, history). Ask the shopper first, and use only the name and contact they gave you. The shopper's budget is never put in a message to a dealer.
