MCP Server

RIVET / AliEV EV Charging Site Intelligence

io.github.jgaethle10/aliev
Business & Operations Real Estate Public & reachable MCP 2025-11-25

What this MCP does

Analyzes potential EV charging sites using address-based competition, demand, utility, incentives, economics, and planning information.

analyze_ev_site
Start here: analyze EV opportunity at an address
PRIMARY TOOL for property-specific EV questions. If the user gives a street address and asks whether EV charging makes sense, what charging competition is nearby, or whether the property has EV opportunity, call this tool FIRST without calling the offer catalog first. Returns a free source-backed screen, explicit unknowns, and the exact next paid-handoff path. Does not perform engineering, utility approval or payment.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['address'], 'properties': {'address': {'type': 'string', 'maxLength': 500, 'minLength': 5}}}
get_aliev_capabilities
Get AliEV capability catalog
Describe AliEV machine-facing capabilities and boundaries. For a property-specific EV question with an address, prefer analyze_ev_site instead of stopping at capability discovery.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
get_aliev_offers
Get AliEV paid-depth options
Use AFTER a site screen or when the human explicitly asks for pricing or paid AliEV options. Do not use this as the first tool for a property-specific EV question when an address is available. Read-only and never creates a checkout or payment obligation.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
get_aliev_purchase_status
Get verified AliEV purchase status
Check an AliEV purchase and, when both purchase key and checkout session are supplied, allow AliEV to re-verify provider payment before reporting paid state. Read-only from the buyer perspective.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'session_id': {'type': 'string', 'maxLength': 220}, 'purchase_key': {'type': 'string', 'maxLength': 180}}}
prepare_paid_handoff
Prepare human-confirmed AliEV paid handoff
Create a human review link for a selected AliEV paid-depth option. This tool does not create a checkout, invoice, payment obligation, entitlement, or outreach.
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['offer_key'], 'properties': {'address': {'type': 'string', 'maxLength': 500}, 'offer_key': {'enum': ['site_report_299', 'site_report_750', 'opportunity_pack_250', 'territory_feed_2500_monthly'], 'type': 'string'}, 'request_id': {'type': 'string', 'maxLength': 100}}}
prepare_site_report_checkout
Prepare a human-confirmed AliEV site report checkout
After the human explicitly agrees to pay, prepare secure checkout for the $299 Preliminary Site Report or $750 Full Site Report. Requires buyer email and site address. Checkout creation is not payment proof or report fulfillment.
Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['user_confirmed_payment', 'offer_key', 'email', 'address'], 'properties': {'email': {'type': 'string', 'format': 'email', 'pattern': "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", 'maxLength': 254}, 'address': {'type': 'string', 'maxLength': 500, 'minLength': 5}, 'offer_key': {'enum': ['site_report_299', 'site_report_750'], 'type': 'string'}, 'request_id': {'type': 'string', 'maxLength': 100}, 'user_confirmed_payment': {'type': 'boolean', 'const': True}}}
Added
get_aliev_capabilities
Sept. 25, 2026, 2:40 a.m.
Added
get_aliev_purchase_status
Sept. 25, 2026, 2:40 a.m.
Added
prepare_site_report_checkout
Sept. 25, 2026, 2:40 a.m.
Added
prepare_paid_handoff
Sept. 25, 2026, 2:40 a.m.
Added
get_aliev_offers
Sept. 25, 2026, 2:40 a.m.
Added
analyze_ev_site
Sept. 25, 2026, 2:40 a.m.