# UtilityAPI MCP for AI Agents AI Agent Connect > UtilityAPI lets you pull billing and smart meter data from over 100 US utilities. It connects your AI agent to providers like PG&E and Con Ed so you can analyze energy usage, manage customer permissions, and pull historical data without building individual integrations. ## Overview - **Category:** data-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_UQcFN9jSbPr5jD0q3QcZWex8kd0ypw9wyAD09b4d/ai-agent-connect - **Tags:** billing-data, energy-usage, meter-data, green-button, utility-api, data-aggregation ## Description UtilityAPI connects your AI agent to the messy world of US utility data. Instead of building a new integration for every single power and gas company, you get a single point of entry for over 100 providers like PG&E and National Grid. You can have your agent pull detailed billing history, check smart meter readings at 15-minute intervals, and manage customer authorizations in one place. It handles the heavy lifting of connecting to different providers, so you can focus on the actual data analysis. If you're looking for a way to aggregate this kind of information, finding it in the Vinkius catalog makes it easy to plug into your existing workflow. Think about how much time you spend hunting down PDFs or jumping between different customer portals just to see how much electricity a home used last month. This Connector removes that friction. You can ask your agent to pull a year's worth of data for a specific meter, and it will return the costs, usage amounts, and time-series readings in one go. This is a game changer for anyone who needs to see the why behind energy bills, like identifying peak AC usage or spotting a gas leak. Whether you're trying to size a solar array for a residential customer or auditing the energy costs of a massive commercial property portfolio, this Connector gives your agent the eyes it needs to see what's happening with energy consumption across the country. You can move from raw data to actionable insights without the manual headache of scraping different websites. ## Tools ### activate_historical_collection Starts a backfill of all available past data for specific meters. This ensures you get a full history instead of just future readings. ### create_auth_form Generates a unique form for customers to grant data sharing permissions. You can use this to set up new data sharing agreements securely. ### get_billing_summaries Shows costs and meter counts for your specific UtilityAPI account. Use this to track your own API usage and billing periods. ### get_bills Pulls detailed billing history including costs and usage for specific meters. This helps you analyze spending patterns and identify high-cost periods. ### get_events Fetches webhook notifications about authorizations and data collection statuses. Use this to monitor your workflows and debug issues. ### get_form_templates Lists the different types of authorization forms available for customers. Use this to see what info you can collect before creating a form. ### get_intervals Retrieves granular 15-minute or hourly smart meter readings for energy analysis. This is ideal for time-series analysis and demand response. ### get_meter_data Combines billing history and interval data into a single set of results for one meter. Use this for a complete picture of a customer's energy profile. ### list_utilities Shows all 100+ supported utility companies and their unique codes. Use this to find the correct ID for any US provider. ### test_form_submission Simulates a customer authorization to test form configurations. Use this during development to ensure your forms work before going live. ### list_authorizations Shows all customers who have granted permission to share their utility data. You can filter these by referral codes to track your leads. ### list_meters Lists all authorized service points with addresses and fuel types. Use this to see every meter in your portfolio at a glance. ## Prompt Examples **Prompt:** ``` Can you pull the last 12 months of billing data for meter 44445555? ``` **Response:** ``` I've retrieved the billing history for meter 44445555 (PG&E - Residential Electric). Here is the summary: | Month | Cost | Usage (kWh) | |---|---|---| | Dec 2024 | $142.30 | 890 | | Jan 2025 | $156.80 | 980 | | Feb 2025 | $134.50 | 845 | **Average monthly cost:** $144.20 **Note:** There is a clear peak in usage during January, likely due to winter heating. ``` **Prompt:** ``` Show me the 15-minute usage intervals for the PG&E meters I have authorized. ``` **Response:** ``` I found 2 authorized PG&E meters. For meter 44445555 (Electric, Residential), there are 3,650 interval readings. The data shows peak usage between 2 PM and 6 PM, which usually correlates with air conditioning. Meter 44445556 (Gas, Residential) shows highest usage between 6 AM and 9 AM for water heating. ``` **Prompt:** ``` What utilities are supported, and how do I get a form for a new customer? ``` **Response:** ``` UtilityAPI supports over 100 utilities, including PG&E, Southern California Edison, Con Edison, and National Grid. To get started with a new customer, you can create an authorization form. Just let me know which utility you are targeting, and I can generate a form ID for you to send to them. ``` ## Capabilities ### Pull smart meter readings Get 15-minute or hourly energy data for precise analysis. ### Fetch billing history Retrieve past costs and usage amounts for any authorized meter. ### Manage customer permissions Create and track authorization forms for secure data sharing. ### List utility providers See which of the 100+ companies are available for integration. ### Backfill historical data Trigger a pull of past records for newly authorized meters. ### Monitor webhook events Track the status of authorizations and data collection in real-time. ## Use Cases ### Sizing a solar array A solar installer asks the agent to pull 12 months of usage for a home to see peak summer AC costs. ### Portfolio auditing A property manager asks the agent to find all meters with high gas usage to identify inefficient heating. ### Loan qualification A lender asks the agent to check a customer's billing history to see if they pay their utility bills on time. ### Energy consulting A consultant asks the agent to compare 15-minute intervals from two different homes to find common energy waste. ## Benefits - Stop building custom integrations for every utility. Use list_utilities to see every provider you can connect to instantly. - Get precise energy models with get_intervals. You can see 15-minute usage spikes instead of just monthly averages. - Speed up solar quotes with get_meter_data. You get both the costs and the technical usage in a single request. - Securely manage customer data. Use create_auth_form to let users grant permission without sharing private credentials. - Audit large portfolios easily. Use list_meters to see every service point in your network with one command. - Automate historical data. Use activate_historical_collection to grab years of past data for new customers. ## How It Works The bottom line is you get a single unified gateway to hundreds of different utility providers. 1. Connect your UtilityAPI token to your AI client via Vinkius. 2. Identify the specific utility and meter you need to access. 3. Ask your agent to pull bills, intervals, or manage customer forms. ## Frequently Asked Questions **What utilities does UtilityAPI support?** UtilityAPI connects to over 100 US utility companies, including major providers like PG&E, Con Ed, and National Grid. **Can I get data for both electricity and gas?** Yes, the Connector pulls data for both fuel types, including billing history and granular usage intervals. **How do I get historical data for a new customer?** You can use the backfill tool to trigger a collection of all available past records for a newly authorized meter. **Does this tool let me pay my utility bills?** No, this Connector is for data retrieval and analysis. It does not handle payments or service adjustments. **How do I get permission from a customer to see their data?** You can create an authorization form through the Connector, which the customer then completes to securely share their info. **Can I see 15-minute smart meter readings?** Yes, the tool provides granular interval data, which is much more detailed than standard monthly bills. **How do I get access to a customer's utility billing and usage data?** First, create an authorization form using `create_auth_form` with the customer's utility code. Share the form URL with the customer to complete authorization. Once authorized, use `list_meters` to find their service points, then `get_bills` and `get_intervals` with the meter UID to retrieve their data. You can also activate historical collection with `activate_historical_collection` to backfill past data. **What's the difference between bills and intervals data?** Bills provide monthly (or billing cycle) summaries: total cost, total usage (kWh/therms), and billing period dates. Intervals provide granular time-series data from smart meters — typically 15-minute or hourly readings showing exact consumption patterns throughout the day. Use bills for cost analysis and trend overview; use intervals for detailed energy modeling, peak demand identification, and time-of-use analysis. **Which utility companies are supported?** UtilityAPI supports 100+ US utilities including PG&E (Pacific Gas & Electric), Southern California Edison (SCE), Con Edison, National Grid, SDG&E, LADWP, CenterPoint Energy, and many more. Use the `list_utilities` tool to see the complete, up-to-date list of supported utilities with their codes. Coverage varies by state and continues to expand. **Can I test the authorization flow before going to production?** Yes! Use `create_auth_form` to create a form, then `test_form_submission` with utility='DEMO' and scenario='residential' (or 'commercial'). This simulates a customer authorizing their data and returns a referral_code. Use this code with `list_authorizations?referrals=YOUR_CODE&include=meters` to retrieve test authorization and meter data without needing a real customer.