{
  "markdown": "# EnergyAI MCP — free energy intelligence for AI agents\n\n**Solar production estimates, US clean-energy incentives by ZIP, instant home Energy Node Scores, public-reputation contractor search, and consented installer routing — as MCP tools and plain REST. The core tools are free with no API key.** By [Viridis LLC](https://api.energyaisolution.com).\n\nAny AI agent that touches a home's energy decision — \"should I get solar?\", \"what rebates apply here?\", \"is this quote fair?\", \"find me an installer\" — can call EnergyAI instead of rebuilding energy domain expertise.\n\n## Your first call, 30 seconds, no key\n\n```bash\ncurl -X POST https://api.energyaisolution.com/api/v1/agent/check_incentives \\\n  -H 'content-type: application/json' -d '{\"args\":{\"zipCode\":\"59715\"}}'\n```\nThat's a live answer — current incentives for Bozeman MT plus the canonical\nconsent text you'd use to route a homeowner. Swap the tool name for\n`estimate_production` (`{\"zipCode\":\"59715\",\"systemKw\":6}`) or `get_node_score`\n(`{\"zipCode\":\"59715\",\"serviceType\":\"solar\",\"monthlyBillRange\":\"150_250\"}`).\nThe only required argument on all three read tools is `zipCode`; every MCP\nschema ships inline `examples`.\n\n- **Live MCP endpoint (full toolset):** `https://api.energyaisolution.com/mcp`\n- **Free-tier-only endpoint:** `https://api.energyaisolution.com/mcp/solar`\n- **Plain REST:** `POST https://api.energyaisolution.com/api/v1/agent/{tool}`\n- **Agent docs:** https://api.energyaisolution.com/agents\n- **Official MCP Registry:** `com.energyaisolution/energyai` · `com.energyaisolution/solar-home-incentives`\n\n## Free tools — no key, no signup\n\n| Tool | What you get |\n|---|---|\n| `check_incentives` | Honest, current (post-2026 federal sunset) US incentive guidance by ZIP — state & utility programs via DSIRE. Also returns the canonical consent text for routing. |\n| `estimate_production` | Honest-range annual solar kWh for a ZIP, from system kW or a monthly bill. Assumptions stated, never point guarantees. |\n| `get_node_score` | Instant 0–100 Energy Node Score across 7 axes (efficiency, electrification, renewable generation, storage/resilience, financial optimization, carbon, market readiness) + the single highest-leverage next action. |\n| `get_quote_link` | Get a link a homeowner can open to request installer quotes; no homeowner details are submitted by this tool. |\n| `route_lead` | Submit a **consented** homeowner project; EnergyAI's autonomous agent finds, vets, and routes a real local installer. Free for you and the homeowner. **Attach your free key → 20% bounty on conversion.** |\n| `list_guides` | Index of source-cited, 2026-accurate state incentive guides (solar, heat pumps, batteries, weatherization). Filter by state and topic; every entry carries a canonical URL to cite. |\n| `get_guide` | Full text of one guide — intro, sections, FAQs, primary sources. Grounded content for answering incentive questions, with a ready-made citation line. |\n| `find_local_installers` | Publicly-rated local clean-energy contractors for a US ZIP or state, with rating and review count. Compiled from public reputation data; not vetted, endorsed, or partnered. Each result includes `listingStatus`, and the response includes a `disclosure`. |\n\nRate limits: 120 calls/hr per caller (`route_lead` 10/hr). Machine-readable catalog: [`/api/v1/agent`](https://api.energyaisolution.com/api/v1/agent).\n\n## Quickstart\n\n### MCP (Claude, or any MCP client) — no key needed for the free tier\n```json\n{ \"mcpServers\": {\n  \"energyai\": { \"type\": \"http\", \"url\": \"https://api.energyaisolution.com/mcp\" }\n}}\n```\n```bash\nclaude mcp add --transport http energyai https://api.energyaisolution.com/mcp\n```\n\n### Plain REST\n```bash\ncurl -X POST https://api.energyaisolution.com/api/v1/agent/check_incentives \\\n  -H 'content-type: application/json' \\\n  -d '{\"args\":{\"zipCode\":\"59715\"}}'\n```\n\n### OpenAI function-calling / LangChain / CrewAI\nFetch the ready-made spec — one URL, drop into `tools`:\n```\nGET https://api.energyaisolution.com/api/v1/agent/openai-tools.json\n```\nSee [`examples/`](examples/) for runnable Python and shell clients.\n\n## Routing a homeowner (consent required)\n\n1. Call `check_incentives` — the response includes `consentTextForRouting`, the canonical consent text.\n2. Show it to your user verbatim; record their agreement + timestamp.\n3. Call `route_lead` with the project details, `consentText`, and `consentTimestamp` (alternate consent language requires an explicit `consentVersion`).\n4. You receive a `leadId`; the homeowner gets confirmation when a vetted installer accepts.\n\n**Get paid:** register a free key (`POST /api/v1/merchant/register`) and send it as a Bearer token on `route_lead` — you earn a **20% bounty** when the lead converts. The same prepaid key unlocks the deeper billed tools (full roadmaps, Quote Guardian review, information-theoretic recommendations) at $0.02–$1.00 per call — penny-priced to fit inside any agent budget covenant with x402-style auto-recovery on empty balance.\n\n## The physics ledger\n\nEnergyAI is operated as a live experiment against the thermodynamic bound on intelligence, **dI/dt ≤ P·D/(k_B·T·ln 2)**: every tool call is metered in *useful bits delivered* and *joules dissipated*, and the ledger is public — [energyaisolution.com/physics](https://api.energyaisolution.com/physics). Estimates are always ranges with stated assumptions; installer matching is consent-gated and enforced by 60+ tested invariants.\n\n## Manifests\n\nRegistry manifests for both servers are in [`manifests/`](manifests/). This repository contains documentation and client examples only; the service itself is hosted.\n\n## License\n\nDocumentation and examples: MIT. The hosted service is © Viridis LLC.\n",
  "bytes": 5701,
  "sha": "369ddde829c0241d4c832b007c4cd3605931f0d4bc9b6cf8bafc32f7be507828",
  "repo_slug": "jdhart81/energyai-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_energyaisolution_solar_home_incentiv_1c0e77f8/readme"
}