How to Use the Hologram.io MCP in Mastra AI

Q: How do I build a multi-step Hologram.io workflow in Mastra AI?

First, connect to this MCP server using new MCPClient. Then, in your Mastra AI agent definition, you can chain tool calls like getdailyusagestats and pausesimdata using conditional logic. Mastra's workflow engine handles the state between steps.

Build resilient IoT automation for Hologram.io with Mastra AI. Finally, a workflow that doesn't fall over.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hologram.io MCP to Mastra AI

Create your Vinkius account to connect Hologram.io to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Hologram.io with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Cost Controls

Stop paying for runaway data usage. With Mastra AI, you can build a workflow that runs `get_daily_usage_stats` on a schedule. If a device crosses a threshold, the workflow can automatically call `pause_sim_data` to stop the bleeding. What if the API call fails? Mastra's engine retries automatically. You can add conditional logic to check a device's importance with `get_device_details` before pausing, so you never brick a critical asset by mistake.

Bulletproof Device Provisioning

Onboarding new devices shouldn't be a manual chore. Create a Mastra AI workflow that takes a new device ID, finds a suitable plan with `list_available_data_plans`, and assigns it. The workflow then confirms the change by checking `list_sim_cards`. This entire process is transactional. If any step fails — like the Hologram API being temporarily unavailable — the workflow can roll back or alert a human. It's set-and-forget automation you can actually trust.

Build Workflows with this MCP Server

Don't wait for a customer to tell you a device is offline. This MCP server gives your Mastra agent the tools it needs to check up on your fleet. A simple workflow can run `get_recent_data_sessions` for all devices listed by `list_iot_devices`. If a device hasn't checked in, the workflow can escalate. It can try to find its last known location with `get_device_locations` or check for errors by reading `list_sms_messages`. This is how you get ahead of problems.

Setup guide

Set up Hologram.io MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Hologram.io tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "hologramio-mcp-client",
  servers: {
    "hologramio-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Hologram.io Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Hologram.io tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Hologram.io transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Hologram.io. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Hologram.io now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Hologram.io MCP in Mastra AI

First, connect to this MCP server using `new MCPClient`. Then, in your Mastra AI agent definition, you can chain tool calls like `get_daily_usage_stats` and `pause_sim_data` using conditional logic. Mastra's workflow engine handles the state between steps.

Absolutely. You'd create a workflow that triggers on a schedule, calls `get_daily_usage_stats`, and if the usage exceeds your threshold, it then calls `pause_sim_data`. Mastra's built-in retry logic makes the process reliable.

Mastra AI itself handles the retries as part of its workflow engine, not the MCP client. This is actually better, as it allows you to configure retry policies (like exponential backoff) at the workflow level, giving you more control over how your agent behaves when APIs are flaky.

Mastra AI's workflow engine will catch the failure. Depending on your configuration, it can automatically retry the call, branch to a different logic path (like sending a Slack notification), or halt the workflow for human intervention.

The server only accesses the Hologram.io data your agent explicitly requests. This includes device and SIM card lists, data usage stats, and device locations. Your Hologram.io credentials are stored securely by Vinkius and are not passed to the Mastra AI agent.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript