# Arcadia Plug MCP for AI Agents MCP

> Arcadia Plug lets your AI client access and manage utility data directly from major providers. It automatically tracks account details, pulls historical billing statements, monitors meter readings across multiple service points, and audits credentials without you leaving your workflow. You can gather usage metrics and cost information for any provider that supports the Arcadia platform.

## Overview
- **Category:** data-management
- **Price:** Free
- **Tags:** utility-data, energy-usage, billing-data, meter-readings, data-aggregation, account-management

## Description

The Arcadia Plug gives your AI agent a direct line into complex utility data platforms. Instead of logging into ten different provider websites to find billing history or meter readings, your agent handles it all in one go. It lets you list every linked account and then pull specific historical statements for cost analysis. You can also track individual meters associated with an account to see granular usage over time.

This means energy managers and financial analysts no longer waste hours jumping between portals. Your AI client pulls the necessary data, whether it's listing credentials or retrieving a detailed statement for a specific billing period. When you connect this MCP via Vinkius, your agent uses secure OAuth 2.0 to pull reliable metrics from hundreds of utility providers consistently.

The result is an immediate view of your organization’s total energy footprint and operational spending, all managed through simple natural language prompts.

## Tools

### get_account_check
Verifies if a specific Arcadia utility account has been successfully connected for data access.

### get_statement
Retrieves the full details, charges, and billing period for one specified historical statement.

### list_accounts
Generates a list of every utility account associated with your organization that can be managed by the AI agent.

### list_credentials
Provides a full inventory and status check of all stored utility login credentials used for data retrieval.

### list_meters
Lists every individual meter or service point across your accounts, allowing you to track usage at specific locations.

### list_statements
Pulls a list of all available historical utility bills and statements for review.

## Prompt Examples

**Prompt:** 
```
List all utility accounts linked to the corporate entity.
```

**Response:** 
```
**✅ Utility Accounts Found:**

*   **Provider:** ConEd Energy Solutions
    *   **Account ID:** 12345678 (Active)
    *   **Status:** Good Standing
    *   **Type:** Electrical
*   **Provider:** City Gas & Light
    *   **Account ID:** G9876543
    *   **Status:** Active
    *   **Type:** Natural Gas

You have 2 primary accounts ready for data retrieval.
```

**Prompt:** 
```
What was the total usage and charges from last year?
```

**Response:** 
```
**📅 Billing Summary (Last Year):**

| Provider | Service Type | Total Charges | Period End Date |
| :---: | :---: | :---: | :---: |
| ConEd | Electric | $14,520.00 | Dec 31, 2023 |
| City Gas & Light | Natural Gas | $6,890.00 | Dec 31, 2023 |

*The total combined utility cost for the period ending December 31, 2023, was **$21,410.00**.*
```

**Prompt:** 
```
Which meters are on account 'C-98765'?
```

**Response:** 
```
**📍 Meters Associated with C-98765:**

The following service points are linked to that account:

*   **ID: met_1122** (Primary Electrical Meter)
    *   **Type:** Electricity
    *   **Location:** Main Office, Level 1
*   **ID: met_3344** (Gas Utility Meter)
    *   **Type:** Natural Gas
    *   **Location:** HVAC Room B
```

## Capabilities

### List and check accounts
Verifies which utility accounts are connected and lists details for every linked account.

### Retrieve detailed billing statements
Pulls full historical records, giving total charges and the exact billing period for any requested statement.

### Monitor service meters
Lists all individual utility meters connected to your accounts, allowing tracking of usage at specific service points.

### Audit system credentials
Shows a list of the unique utility login credentials that the agent uses to access your data.

## Use Cases

### Auditing Energy Sprawl Across Multiple Sites
An energy manager needs to confirm usage for three different facilities (gas, electric, water). They prompt the agent, and it uses list_accounts and then calls list_meters repeatedly to provide a consolidated report of all active service points.

### Preparing Annual ESG Reports
A sustainability director needs usage data from the last five years for carbon reporting. The agent uses list_statements followed by get_statement on multiple dates, pulling raw consumption numbers into a spreadsheet format for immediate analysis.

### Optimizing Operational Costs
A financial analyst suspects an old site's billing rate is outdated. They use the agent to list_accounts and get_statement on that specific account, providing the raw charges and dates needed to challenge current rates.

### Troubleshooting Missing Data
A facilities engineer can't find a meter reading for Site B. They use the agent to list_meters for their main account ID to confirm if that specific service point is even registered in the system, saving days of physical checks.

## Benefits

- Stop manually checking connectivity. Use get_account_check to instantly verify if an account is active and ready for data pulling.
- Get a complete picture of your asset base by using list_meters, which finds every service point tied to your accounts, not just the main meter.
- Compare costs across years easily. You can use list_statements combined with get_statement to pull multiple billing cycles and compare charges quickly.
- Audit access points instantly. List_credentials shows exactly what login details are being used by your agent, which is critical for security checks.
- Consolidate spending data. By accessing all accounts via list_accounts, you can track utility expenditure across every site in one place.

## How It Works

The bottom line is that your AI client handles all the complex API calls and data aggregation behind the scenes so you just get a clear answer about your utility usage.

1. Your AI client first authenticates with Arcadia Plug, granting permission to access all linked utility accounts and meters.
2. You prompt your agent with a request, like 'What were the charges for our main site last quarter?' The agent then uses the appropriate tool (like list_statements) to find the needed billing period.
3. The agent retrieves the raw data—whether it's account numbers or detailed usage metrics—and presents the clean, summarized information back to you.

## Frequently Asked Questions

**How does Arcadia Plug help me track utility bills from different providers?**
It pulls statements from multiple utilities into one place, letting you compare charges side-by-side. You simply ask for the timeframe, and it gathers all necessary billing details automatically.

**Can I use Arcadia Plug to see my total energy usage across all buildings?**
Yes, by listing all accounts and then finding individual meters using list_meters, you can get a comprehensive picture of consumption points across your entire portfolio. It aggregates the data for you.

**What if I need to check an old utility bill that isn't easily found?**
You first use list_statements to see all available billing records, and then request details using get_statement on a specific date or period. It helps you locate any historical data point.

**Is Arcadia Plug secure for handling sensitive login information?**
Yes, it uses industry-standard OAuth 2.0 security protocols to access your data. You can even use list_credentials to audit exactly what logins are being used by the system.

**What kind of data does Arcadia Plug provide for ESG reporting?**
It provides granular usage metrics and historical billing records necessary for carbon footprint analysis. You get reliable, dated consumption numbers that you can use directly in your reports.