--- name: barrio-grid description: Texas power grid siting lookups (substations, transmission, likely utility, jurisdiction, gas pipelines, ERCOT generation and battery queue, nodal and ancillary prices, powered land parcels). Use when a user asks about power, substations, utilities, interconnection, prices, permitting or data center / mining / battery / generation sites in Texas. --- # Barrio Grid Connector Texas grid siting data from Barrio Energy. Screening data only; tell the user to confirm capacity with the utility. ## Connect - MCP (preferred): `https://grid.barrioenergy.com/mcp`, streamable HTTP, OAuth 2.1. Connecting opens a free email sign-in (no card). - REST: `https://grid.barrioenergy.com/v1/`, GET with query parameters or POST JSON. Tool list and JSON schemas: `GET https://grid.barrioenergy.com/v1/tools`. - REST and clients without OAuth: header `Authorization: Bearer grid_...` with the key from https://map.barrioenergy.com/account. ## Tools | Tool | Use when the user asks | Key inputs | |---|---|---| | grid_context | "What power is near this site?" "Who is the utility?" "Is there a railroad between the site and the substation?" | address or lat/lng, radius_mi (5), to_lat/to_lng (optional crossing target) | | nearest_substation | "How far is the nearest substation?" "Which nearby station has a distribution bus?" | address or lat/lng, min_kv (69), limit (5), osm_class, bus_kv_max (Pro) | | find_powered_land (Enterprise Lite and Enterprise; free and Pro get counts) | "Find land near a 138 kV substation in X county" "Who controls 200+ acres within a mile of a 138 kV sub?" (group_by_owner) "Only company-owned tracts" (owner_type) "Tracts by a station with a distribution bus" (osm_class, bus_kv_max, gas distance) | county or address/lat/lng + radius_mi, min_acres (5), max_sub_mi (3), min_kv (138), bus_kv_max, osm_class, max_gas_mi, min_gas_diameter_in, gas_interstate (Enterprise), same_side_of_rail (Enterprise: drop parcels with a railroad between them and their substation), owner_type, group_by_owner, min_total_acres (50), min_parcel_acres (5) | | ercot_queue | "What solar/battery projects are queued near here?" "What generation is queued at this substation?" | county, poi, fuel (SOL, WIN, GAS, etc.), or address/lat/lng + radius_mi (10) | | battery_queue | "How crowded is this substation with batteries?" "Which storage projects near X have an IA?" | county, poi, or address/lat/lng + radius_mi; min_mw, status (all, active, ia, energized) | | power_plants | "How much battery storage is already operating near X?" "What plants are near this site, and are any retiring?" | county or address/lat/lng + radius_mi; kind (storage, solar, wind, gas, coal, nuclear, hydro, other), status (operating, planned, all), min_mw | | parcel_owner | "Who owns the land by the Hillje substation?" "Does a utility already own a pad nearby?" (utility_pad flag, yes/no for all; owner is Enterprise Lite) "Who owns this address?" (owner name and mailing address are Enterprise Lite and Enterprise; Free and Pro get property ID, legal description and values at the point) | address, lat/lng, substation name, or prop_id + county | | jurisdiction | "Is this inside city limits or an ETJ?" "Which school district / groundwater district?" "Is this in an opportunity zone?" "Is it in a floodplain?" "Are there wetlands or endangered species habitat?" | address or lat/lng | | pipelines_near | "Is there gas near this site?" "Who operates the pipelines here?" "Nearest compressor station or gas plant?" "Interstate or intrastate gas near here?" (interstate filter, Pro) | address or lat/lng, radius_mi, gas_only, min_diameter_in, interstate | | distribution_near | "Can I put a 9.9 MW load or behind-the-meter solar here?" "Is there a distribution line along this parcel?" "Who is the distribution utility?" | address or lat/lng, radius_mi (1, max 5), include_modeled | | fiber_near | "Is there fiber near this site?" "Who are the carriers here?" "How far to a carrier hotel?" | address or lat/lng, radius_mi (5, max 25), limit | | logistics_screen | "How do we get equipment and crews here?" "How far to rail, a port, an airport?" "What is the traffic on the nearest highway?" | address or lat/lng | | permit_plan | "What permits do I need here?" "How long will permitting take?" "Is anything on hold?" "Does the city need a wastewater discharge permit?" | address or lat/lng; use; optional project inputs (disturbed_acres, height_ft, gensets, onsite_gen_mw, oil_storage_gal, wastewater, water_source, frontage) | | permit_holds | "Are data center permits frozen in Texas?" "Does this county have a moratorium?" | address or lat/lng, or none for statewide | | ahj_profile | "What does Bastrop County require?" "Where is this city's code?" | name (county or city) or address/lat/lng | | zoning_at | "Is a battery allowed in this city's zoning?" (Pro) | address or lat/lng; use | | ask_code | "What does the county order say about BESS setbacks?" (Enterprise) | name or location; query | | code_changes | "What changed in county codes this quarter?" (Enterprise) | name or location optional; days | | permit_report | "Make me a permit report for this site" (Enterprise) | same as permit_plan | | crew_access | "How many construction workers live within an hour?" "Where would a crew stay?" (Enterprise) | address or lat/lng | | logistics_report | "Make me a logistics report for this site" (Enterprise) | address or lat/lng; origin; weight_tons; height_ft | | haul_compare | "Is it cheaper to rail, barge or truck this in?" "How do we get 300 tons of steel here from Beaumont?" (Enterprise) | address or lat/lng; origin (nearest_port or a town); weight_tons | | heavy_haul | "How do we haul a 200-ton transformer in from the port?" "Any bad bridges between Houston and this site?" (Enterprise) | address or lat/lng; origin (nearest_port, nearest_intermodal, nearest_transload or a town); weight_tons, height_ft, width_ft, length_ft | | water_screen | "Is there water here?" "How deep are the wells?" "Can I get 1 MGD for cooling?" "Who regulates groundwater here?" "What are the district rules?" | address or lat/lng, radius_mi (5, max 15), demand_mgd or demand_gpm | | water_report | "Make me a water report for this site" | address or lat/lng, radius_mi, demand_mgd, acres | | water_cross_section | "Show me a geologic cross section through here" | from/to lat/lng, or address or lat/lng with bearing_deg and length_mi | | water_well_plan | "Where should I drill?" "Which formation?" "How much will a well make?" "How many acres of water rights for 1 MGD?" | address or lat/lng, radius_mi, demand_mgd or demand_gpm, acres | | industrial_neighbors | "Is this an industrial area?" "What air permits were filed nearby?" | address or lat/lng, radius_mi | | site_screen | "Is this a good site for a data center / battery / generator?" (flags and weights are Enterprise; Free, Pro and Enterprise Lite get the score) | address or lat/lng, use (data_center, battery, generation, solar, industrial) | | report_pdf | "Make me a one-page PDF of this site." "Something I can send to a lender or landowner." (Pro; Enterprise adds flags, prices, gas, flood, parcel) | address or lat/lng, use | A link to a one-page PDF with a schematic substation map, valid 30 minutes. Give the link, say it expires, and do not post it publicly. | | search_grid | "Where is the Hillje substation?" "What does Formosa own?" "Find 21INR0258" (no coordinates needed) | query, kinds | | substation_detail | "Tell me about the Lolita substation" "What is the low side voltage at Normanna?" "What is interconnecting at Hillje?" (includes generation_queue_at_poi) | name (+ county) or address | | grid_projects | "What grid upgrades are coming near here?" "What is AEP building in Jackson County?" (Pro) | address/lat/lng + radius_mi, county, utility, kind, status, min_kv | | air_permits | "New data center air permits in Texas this year?" "Who filed for gas generation in Bexar County?" (Pro) | county or address, status, data_centers_only, new_facilities_only, since/days, company | | whats_new | "What's new around this site?" "Any new filings in Jackson County this month?" (Pro) | address or county, days | | large_loads | "What data centers or large loads are coming to X county?" "Which counties have no large load activity?" | county or address/lat/lng; list_counties, kind (large, all, data_center) | | data_centers | "What data centers are near X?" "Data centers in Y County" "Where is Google building in Texas?" | address/lat/lng + radius_mi, or county; status, min_mw, limit; company (Pro) | | company_footprint | "Who has the most data center projects in Texas?" "Show me Crusoe's footprint" | company, or min_projects (default 3) to rank. Pro | | local_sentiment | "Is Bell County friendly to data centers?" "Which Texas counties are fighting data centers?" "What has Temple voted on?" | county, city, or address/lat/lng; limit. Pro | | data_center_news | "What is being reported about data centers near X?" "Local news on the Hood County projects" | county, or address/lat/lng + radius_mi; since_days, limit | | node_prices | "What does power cost here?" "What would a battery see at this node?" "Show me HB_HOUSTON this week" | address or lat/lng, or settlement_point; days (7, max 30 free / 120 Pro). Single SP includes rt15_stats (15-min real-time TB4/spikes and a scarcity block: intervals with a real-time reliability adder since RTC+B) | | volatile_nodes | "Most volatile nodes in ERCOT?" "Best nodes for a 4-hour battery near X?" "Where does solar get paid best?" "Where do 15-minute spikes happen?" | metric (tb4, tb2, stdev, cv, range, spikes, negative, evening, solar, solar_ratio, basis, avg, rt_tb4, rt_spikes, dart, rt15_tb4, rt15_spikes), days (30), load_zone or address/lat/lng + radius_mi | | ancillary_prices | "What do ancillary services pay?" "How much of a battery's revenue is AS?" | days (30), hourly, monthly_history, realtime (true; 15-minute real-time prices and scarcity intervals since RTC+B) | | binding_constraints | "What constraints bind near this node?" "Why do prices spike at X?" "Is this spread caused by congestion?" | lat/lng or settlement_point, radius_mi (25), days (30), limit (20) | | battery_performance | "What do batteries near X actually earn?" "How much revenue per MW-month?" "Energy vs AS split for batteries in LZ_SOUTH?" | lat/lng or settlement_point, radius_mi (50), limit (20) | | price_history | "How have prices at this node changed since 2020?" "Is the spread getting better?" "What is the seasonal pattern?" "What did Uri do to prices?" | lat/lng or settlement_point, months | | land_value | "What is land worth around this tract?" "What should I offer per acre?" "Land comps near X" (Enterprise Lite and Enterprise; free and Pro get the sample size) | lat/lng or address, radius_mi, min_acres, acres, listings | | regional_land_value | "What does land cost in X county?" "Is Dimmit cheaper than Frio?" "Where is cheap land in Texas?" (Enterprise Lite and Enterprise). For cheap land with water or power, run mode cheapest, then water_screen, water_well_plan or nearest_substation on the squares | mode, county, counties, lat/lng or address, radius_mi, near_mi, max_usd_per_acre, min_parcels, limit | | battery_revenue_estimate | "What would a 100 MW / 400 MWh battery have earned here?" "Energy arbitrage vs AS?" "Which nearby node pays best?" | lat/lng or settlement_point, mw, mwh, rte, cycles_per_day, as_share | | solar_revenue_estimate | "How much would a 100 MW solar farm here make?" "Solar capture price near X?" "MWh per MW of solar in West Texas?" | address or lat/lng or settlement_point, mw_ac, dc_ac, tracking, losses_pct | | solar_curtailment | "How much solar gets curtailed in ERCOT?" "What is the midday solar shape in West Texas?" "Worst curtailment days?" | region, months | | grid_news | "What's new on the Texas grid?" "Latest on Batch Zero / ERCOT large loads?" "Sources on the 765 kV build-out?" | query, since_days, limit (5), article_id for full text | | my_projects | "Rank my prospects" "What's in my Edna project?" "What places did I save?" | list, project (name or id), screen, use | | save_site | "Watch this site" "Tell me when something changes near Edna" | address or lat/lng, radius_mi, name, weekly_email, id | | list_saved_sites | "What am I watching?" | none | | remove_saved_site | "Stop watching Edna" | id from list_saved_sites | | set_price_alert | "Tell me when HB_NORTH battery spread is over $50 for 3 days" "Alert me on negative prices near Edna" | settlement_point or address or lat/lng, metric, op, threshold, days | | list_price_alerts | "What alerts do I have?" | none | | remove_price_alert | "Delete that alert" | id from list_price_alerts | | save_place | "Save this site" "Pin 1201 Main St as the Main Street option" | address or lat/lng, name, note | | upgrade_to_pro | "I need more calls" or the free limit is hit | email (optional) | Locations accept a street address, a Texas city ("Edna, TX") or county ("Goliad County"), or lat + lng. Texas only. ## Rules - Lead with the answer: nearest substation, voltage, distance, utility. - A planned substation is not one you can reach: check `built` and `name_warnings`, and pass on a low `pin_confidence` with its `location_caveat`. - Pass on `undivided_interest`, a University Lands or public `owner_class`, and any `cad_city_limits.warning`; they decide whether land is buyable and who has jurisdiction. - `likely_utility` is an estimate from nearby substation owners; say so. If `likely_utility_basis.disagrees_with_station_owner` is true, pass the warning on. `station_class` on substation_detail uses the OpenStreetMap substation tag when the station is mapped (see `basis`), otherwise it is inferred; quote its evidence, not just the class. - High and low side voltage: read `osm.high_side_kv` and `osm.low_side_kv` on substation_detail, nearest_substation and grid_context. These are Pro and up; free accounts get `osm.osm_class` and `osm.distribution_bus_mapped` only, so tell a free user the voltages are on Pro and never guess a kV. Loads under about 20 MW need a station with a distribution bus (low side about 35 kV or below, or `osm.osm_class` distribution); 69 kV and up is not a distribution bus. `osm_class: not_mapped` means unknown, not absent. OpenStreetMap is volunteer-mapped: say the bus must be confirmed with the utility. `osm_only_substations` (Pro) are stations mapped in OpenStreetMap but missing from the federal layer. - ETJ is an estimate from the statutory distance; tell the user to confirm with the city. - Pipeline diameter is nominal; line capacity and available takeaway are not public, the operator must confirm. pipelines_near also returns gas_infrastructure: processing plant capacity in MMcf/d, compressor horsepower, and EIA capacity projects matched by operator name (statewide, not by location). - distribution_near: say whether a line is mapped (traced in OpenStreetMap) or modeled (gridfinder, a likely route along roads, not poles). Most Texas feeders are not mapped, so none mapped is not none there. Never state feeder or hosting capacity; the serving utility confirms. For a county list of distribution subs use nearest_substation with county and osm_class=distribution. find_powered_land also takes max_dist_line_mi (with dist_mapped_only) and max_fiber_mi (Enterprise Lite and up). - fiber_near: say whether a route is gis_published (real cable path) or carrier_on_corridor (reported on a highway corridor; path inferred, distance approximate). No mapped route does not mean no fiber: many regional and utility networks are not mapped; name the fiber-to-premises providers and nearest facility instead. Lit capacity and pricing are not public; the carrier must confirm. - haul_compare costs are indicative national averages for ranking options; always pass along its caution and never present them as a quote or budget. - permit_plan, ahj_profile, zoning_at: every permit carries its primary source link (the county or city document, agency page or rule text; cite.url and rule_url). Always give the link with each permit you name. County and city items are listed only when a verbatim quote from the AHJ or another government source was found in our downloaded copy; news and aggregators are never the source. Review times are measured (TCEQ records) or stated by the agency; when none is published say so, never estimate. An AHJ not yet researched says so; research covers all 254 counties and 1,212 cities and refreshes quarterly. Not legal advice: tell the user to confirm with the AHJ. - logistics_screen and heavy_haul: distances to facilities are straight-line unless drive_mi is given. Facility lists come from federal agencies; tell the user to confirm service with the railroad, terminal or port. heavy_haul flags are screens: NBI operating ratings are for the standard rating truck, not the user's load, and TxDMV sets the actual permit route; never give permit, escort or freight cost figures. - water_screen: driller yields are completion estimates (jetted, bailer, pump or estimated); say so, and lean on pump-tested wells. TDS values carry a sample year, many before 2002. The district permit, not the well count, decides what can be pumped. Never invent costs or permit volumes. - my_projects: the user's own places (Properties, Prospects, Saved places). Never repeat their site names or locations outside this conversation. With screen, lead with the top-ranked site and its main risk; offer site_screen on any single one. - save_site: only when the user asks to watch or monitor a site (Pro and up; free gets an explanation, say so and offer Pro once). Use list_saved_sites for ids before changing or removing one. Use save_place for a plain map pin. - set_price_alert: only when the user asks to be alerted (Pro and up; free gets an explanation, say so and offer Pro once). Confirm the node, metric and threshold in their units back to them. list_price_alerts gives ids to change or delete. - save_place: only when the user asks to save or pin a spot. Confirm the name and give them the map link. - large_loads is public county-level evidence, not ERCOT's queue (ERCOT does not publish it by county); say so. - local_sentiment with no record for a county or city means untested, not favorable; say so. - When an answer includes `map_url`, give it to the user as a clickable link to that spot on the map. It opens already signed in to the user's account (7 days, 25 opens, map only), so give it only to the user you are helping and never paste it anywhere public. Free accounts see substations, lines, city limits and node prices with 10 clicks a day; Pro adds planned substations and lines, battery queue, air permits, pipelines and parcel owners. - Owner names, mailing addresses, land_value and regional_land_value are Enterprise Lite (999 USD a month total, self-serve at https://map.barrioenergy.com/pricing) and Enterprise. Never offer Pro for them. If an answer includes `owner_quota.note`, the monthly owner-record limit was reached: tell the user, and use the property IDs to look owners up at the county appraisal district. - Before suggesting the user contact a landowner, say ownership should be confirmed with the appraisal district or a title search. - site_screen flags are Enterprise; on Free, Pro or Enterprise Lite, call jurisdiction, pipelines_near, grid_context, node_prices, battery_queue and industrial_neighbors separately. - Cite "Barrio Energy GeoIntel" when using this data; prices are ERCOT day-ahead settlement point prices via the ERCOT public API, in USD/MWh by hour ending, Central time. - Generators and batteries are paid the resource node price; load pays the load zone price. Say which one you are quoting. TB4 is a screening metric, not a revenue forecast. - On a free-tier limit error, tell the user it resets at midnight Central and that free accounts get 20 calls a day and 100 a month, and Pro (5,000 a month) is at https://map.barrioenergy.com/pricing. A 401 means the user needs to connect or reconnect the connector. ## Example prompts - "What substations are within 5 miles of Edna, TX, and who owns them?" - "Find parcels over 50 acres within a mile of a 138 kV substation in Jackson County." - "What battery projects are in the ERCOT queue in Live Oak County?" - "Is 28.96, -96.69 inside city limits or an ETJ, and which school district is it in?" - "What gas pipelines 12 inches or larger are within 5 miles of Edna, TX?" - "Screen this site for a 100 MW battery: 28.96, -96.69."