How to Use the CloudCard ID Photos MCP in Mastra AI

Q: Can Mastra AI automatically retry failed CloudCard ID Photos approvals?

Yes, you can define a workflow step around approveidphoto with exponential backoff. Mastra AI will automatically retry the API call if CloudCard returns a transient error.

Q: How do I verify API connectivity inside a Mastra workflow?

Use the checkapihealth tool as a prerequisite step in your workflow DAG. If the health check fails, the workflow pauses before trying to process cardholder updates.

Build resilient, auto-retrying CloudCard ID Photos workflows with Mastra AI agents.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect CloudCard ID Photos MCP to Mastra AI

Create your Vinkius account to connect CloudCard ID Photos 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 CloudCard ID Photos with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Resilient Rejections with Mastra AI

When an ID photo gets rejected via `deny_id_photo`, you don't want a network hiccup to lose the rejection reason. Mastra AI lets you wrap this call in a workflow that automatically retries if the CloudCard API is temporarily down. If the retry limit is hit, your Mastra AI workflow branches to notify your team via Slack or logs the error so no cardholder is left in limbo.

Multi-Step Onboarding Pipelines

Managing hundreds of new university cardholders is messy. Your Mastra AI agent can run a loop using `list_cardholders` to find missing profiles, then execute `register_new_cardholder` for each one. It uses Mastra AI conditional logic to check if a webhook is active with `list_configured_webhooks`, ensuring your system gets notified the moment they upload their photo.

Location-Based Photo Routing

This MCP Server exposes `list_card_offices` so your Mastra AI agent can dynamically route physical card printing. Based on the cardholder's location, the agent assigns the correct pickup spot. You can build a Mastra AI workflow that checks `get_cardholder_details` and automatically sends the approved photo to the nearest printing office.

Setup guide

Set up CloudCard ID Photos 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 CloudCard ID Photos 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: "cloudcard-id-photos-mcp-client",
  servers: {
    "cloudcard-id-photos-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

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

Install the Mastra MCP package, then initialize a new MCPClient with your Vinkius server URL. You can then list and spread the tools directly into your Mastra agent definition.

Yes, you can define a workflow step around `approve_id_photo` with exponential backoff. Mastra AI will automatically retry the API call if CloudCard returns a transient error.

Yes, you can configure Mastra AI to require manual approval before executing sensitive operations like `deny_id_photo` or `approve_id_photo`.

Use the `check_api_health` tool as a prerequisite step in your workflow DAG. If the health check fails, the workflow pauses before trying to process cardholder updates.

Vinkius runs this integration in a zero-trust, ephemeral environment. Your cardholder names, emails, and uploaded ID photos are transmitted using enterprise-grade TLS directly to CloudCard, ensuring your local Mastra agent never leaks sensitive data.

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