How to Use the HID Origo MCP in Mastra AI

Q: How do I configure Mastra AI to use the HID Origo MCP Server?

Initialize an MCPClient with your Vinkius server URL. Mastra auto-detects the Streamable HTTP transport and spreads the available tools directly into your agent's toolkit.

Q: Can Mastra AI retry failed HID Origo identity invitations?

Yes. If createenrollmentinvitation fails due to a temporary network issue, Mastra's built-in workflow engine automatically retries the call using exponential backoff.

Q: Does the HID Origo MCP Server support Mastra AI human-in-the-loop?

It does. You can set requireToolApproval for sensitive actions like issuing new credentials. The workflow pauses until a human admin reviews the request.

Q: Can I branch logic based on HID Origo user status?

You can. Your workflow can check getuserdetails and route the execution path differently depending on whether the user has an active mobile identity or just a physical badge.

Automate complex HID Origo access control workflows with Mastra AI using conditional branching and built-in retries.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HID Origo MCP to Mastra AI

Create your Vinkius account to connect HID Origo 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 HID Origo with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain identity and enrollment steps

Provisioning a new HID Origo user is rarely a single API call. With Mastra AI, you build a workflow that first verifies the employee exists using `list_identity_users`. If the user is missing, the workflow branches to notify IT. If they exist, the agent automatically proceeds to `create_enrollment_invitation`. Because Mastra AI handles failures gracefully, a timeout from the HID Origo MCP Server just triggers an exponential backoff retry. The new hire gets their mobile credential without manual hand-holding.

Monitor and revoke mobile identities

When an employee loses their phone, your agent needs to revoke their HID Origo mobile identity fast. It can execute `list_mobile_identities` to find the active digital cards associated with that specific person. You can configure Mastra AI to require human approval before taking destructive actions. The workflow pauses, pings a Slack channel for an admin's okay, and then proceeds to verify the specific credential details via `get_mobile_identity`.

Diagnostic workflows for door readers

When a HID Origo door controller stops responding, your Mastra AI agent can run a diagnostic sequence. It starts by pulling the hardware status with `list_access_readers`. Next, it pulls recent activity using `get_audit_log_events` to see exactly when the reader dropped offline. The agent compiles this data, checks the organization metadata via `get_organization_info`, and files a detailed Jira ticket for the maintenance team.

Setup guide

Set up HID Origo 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 HID Origo 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: "hid-origo-mcp-client",
  servers: {
    "hid-origo-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent HID Origo 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 HID Origo. 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 HID Origo 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 HID Origo MCP in Mastra AI

Initialize an `MCPClient` with your Vinkius server URL. Mastra auto-detects the Streamable HTTP transport and spreads the available tools directly into your agent's toolkit.

Yes. If `create_enrollment_invitation` fails due to a temporary network issue, Mastra's built-in workflow engine automatically retries the call using exponential backoff.

It does. You can set `requireToolApproval` for sensitive actions like issuing new credentials. The workflow pauses until a human admin reviews the request.

You can. Your workflow can check `get_user_details` and route the execution path differently depending on whether the user has an active mobile identity or just a physical badge.

The server processes raw employee identity records and physical access logs. Vinkius routes this traffic through a zero-trust architecture where the MCP connection is torn down immediately after use, ensuring no identity data is cached.

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