# Hologram.io MCP MCP > Hologram.io MCP lets your AI agent manage an entire IoT device fleet through natural conversation. You can list every connected asset, monitor real-time data usage for billing cycles, check approximate global locations, and instantly pause or unpause SIM card services—all without jumping between dashboards. ## Overview - **Category:** cloud-infrastructure - **Price:** Free - **Tags:** cellular-connectivity, sim-management, device-fleet, iot-monitoring, data-usage ## Description Managing a large network of remote devices usually means living in a state of dashboard chaos. You're constantly clicking through tabs just to find out if the billing cycle is nearing an overage or if that specific device went offline last night. This MCP connects your entire global cellular fleet into your agent, giving you full control via conversation. You can ask it to pull up a list of all devices and check their current operational status. Need to know how much data they've used this month? Just ask for the billing cycle usage. Your agent pulls that data, then checks if specific SIM cards need pausing or resuming service immediately. It’s like having a dedicated IoT Operations Manager who lives inside your AI client. You don't have to export logs anymore or manually check status screens; you just talk to it and get actionable results. This integration makes managing complex connectivity simple, giving you the power of the entire Vinkius catalog right where you work. ## Tools ### get_billing_cycle_usage Checks the total data consumed for the current billing cycle period. ### get_daily_usage_stats Pulls aggregated data usage statistics broken down by day. ### get_device_details Retrieves full, detailed information for one specific IoT device ID. ### get_device_locations Finds the approximate GPS coordinates for all connected devices using cell tower triangulation data. ### get_recent_data_sessions Retrieves a list of the most recent data sessions used by your entire fleet. ### list_available_data_plans Lists all possible data plans that can be activated across your organization's accounts. ### list_iot_devices Provides a full inventory list of every IoT device in the account and its current status. ### list_sim_cards Lists all cellular SIM cards, showing which plans are attached to each one. ### list_sms_messages Retrieves the history of text messages originated from your connected devices for logging or troubleshooting. ### pause_sim_data Temporarily suspends data services on a specific cellular link, requiring its ID number. ### unpause_sim_data Resumes active data services for a SIM card that was previously suspended. ## Prompt Examples **Prompt:** ``` List all IoT devices and show which ones are currently active. ``` **Response:** ``` I've retrieved your device list. You have 12 devices in your fleet, including 'Sensor Unit 01' (Active), 'Gateway Beta' (Active), and 'Tracker 05' (Suspended). Would you like to see the recent data usage for the active devices? ``` **Prompt:** ``` Show me the total data usage for the current billing cycle. ``` **Response:** ``` Accessing billing usage... For the current cycle, your fleet has consumed 450.2 MB of data. Your monthly allowance is 1 GB, leaving you with 549.8 MB remaining. Should I check which device has the highest consumption? ``` **Prompt:** ``` Find the approximate location of all devices in my account. ``` **Response:** ``` Retrieving fleet locations... I've mapped your devices based on cell tower data. Most of your fleet is currently concentrated in the 'Greater Chicago Area', with 2 units appearing near 'San Francisco'. Would you like the specific coordinates for any device? ``` ## Capabilities ### Inventory Device Status List every IoT device in your account and check its specific details or current operational status. ### Monitor Data Consumption & Billing Check total data usage for the current billing cycle, review daily stats, or view recent data sessions to catch overages early. ### Control SIM Service State Temporarily suspend data service on a specific SIM card or resume it instantly from the chat interface. ### Track Location and Movement Get approximate GPS coordinates for your entire fleet based on cell tower triangulation, even if devices aren't sending explicit location pings. ### Manage Cellular Links & Plans View all active SIM cards, their associated data plans, and the history of device-originated SMS messages. ## Use Cases ### Tracking an unexpected data spike The ops lead notices a sudden cost increase. They ask their agent to check the billing cycle usage, which reveals a spike. The agent then checks get_device_details for the device responsible and gets its current location via get_device_locations so they can dispatch maintenance personnel immediately. ### Onboarding new devices An engineer needs to verify connectivity on a new unit. They first run list_iot_devices to confirm the ID, then use get_daily_usage_stats to ensure baseline usage is zero before going live. ### Emergency service interruption The field team reports that a gateway isn't sending location data. The agent first lists_sim_cards to confirm the active plan, then uses pause_sim_data and unpause_sim_data to cycle the connection and see if service resumes. ### Forensic investigation A manager needs to audit why a device was transmitting messages when it shouldn't have. They ask for list_sms_messages history, then check get_recent_data_sessions to correlate message activity with data consumption. ## Benefits - You don't have to manually jump between dashboards to check status. You can ask the agent to list all devices and get their current operational state in a single query, which is much faster than checking multiple tabs for each asset. - Catch overages before they happen. By running `get_billing_cycle_usage`, your agent immediately tells you how much data was used this month compared to your allowance, saving you from unexpected bills. - Control the network instantly. If a device isn't transmitting data and you think it's costing money, use `pause_sim_data` to cut off service right from your chat window—no need to log into the billing portal. - Pinpoint assets globally. Instead of guessing where things are, running `get_device_locations` gives you approximate GPS coordinates based on cell tower data for every device in your fleet. - Deep troubleshooting is easy. Need to know why a message failed? The agent can pull up the history using `list_sms_messages` and also check the recent usage via `get_recent_data_sessions`, giving you both context and proof. ## How It Works The bottom line is you connect once in Vinkius; then you manage everything else through natural conversation with your AI client. 1. First, subscribe to this MCP and enter your Hologram API Key (you find this in the platform's Dashboard > API). 2. Next, connect it to any compatible client—like Cursor or Claude—so your agent can access the toolset. 3. Then, ask your agent a question like, 'What is the current data usage for my fleet?' and it executes the necessary calls against Hologram's live data. ## Frequently Asked Questions **How do I find my Hologram.io API Key?** Log in to your Hologram dashboard, click on your profile/organization name, navigate to **Settings**, and select the **API** tab. You will find your unique API Key there. **Can I pause data for a specific device?** Yes! Use the `pause_sim_data` tool by providing the unique cellular link ID for that device. This will change its state to 'suspended' and stop data usage immediately. **How accurate is the device location feature?** The location data provided by `get_device_locations` is approximate and based on cell tower triangulation. It is generally accurate within a few hundred meters to a few miles depending on tower density. **Is the integration secure for managing my IoT fleet?** Absolutely. The integration uses industry-standard Basic Authentication over HTTPS. Your credentials and connectivity data are encrypted and stored securely within the Vinkius Cloud infrastructure. **How can I use `list_available_data_plans` to check what usage tiers are available?** The tool lists every data plan you can activate. This lets you compare different bandwidth limits and costs against your current operational needs before committing to a new subscription. **If I need deep stats, how do I use `get_device_details` for a specific unit?** It pulls comprehensive information for one device ID. You get more than just status—you retrieve metadata like serial numbers and model specifics necessary for advanced inventory tracking. **How do I use `list_sms_messages` to check communication logs?** This tool retrieves the history of SMS messages generated by your devices. It’s critical when you need a log trail of device-initiated communications for compliance or troubleshooting purposes. **What should I do first to get an inventory using `list_iot_devices`?** Running this tool gives you a complete, current roster of every IoT unit in your account. Use it early on when setting up or auditing the scope and status of your entire connected infrastructure.