How to Use the Showpad MCP in Mastra AI

Q: What if I need to search for assets in Showpad, but it fails? How does mastra-ai handle that?

Mastra handles failures gracefully. If searchassets throws an error or times out, your workflow can automatically retry the query with exponential backoff until a valid result is returned.

Q: How do I build a multi-step process involving Showpad users in mastra-ai?

You first call listusers to get the full directory. The workflow then checks if the required user exists, and if so, it calls getuserdetails to pull specific profile data needed for the next step.

Q: How do I check Showpad asset status for governance in mastra-ai?

Run a sequence: 1) Call listassets to get IDs. 2) Pass those IDs one by one to getassetdetails. This verifies the current metadata and ensures compliance across the board.

Q: If I need data privacy controls for Showpad, what information does mastra-ai manage?

The server touches user profile data (getuserdetails) and asset metadata (via listassets). Your workflows can be designed to only pass the minimum required data between steps.

Build complex, resilient Showpad workflows using the TypeScript Agent framework.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Showpad MCP to Mastra AI

Create your Vinkius account to connect Showpad to Mastra AI — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Showpad with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Validate content needs across divisions.

The `list_divisions` tool fetches all organizational units within Showpad. You can build a workflow that automatically routes data or tasks based on which division the user belongs to. This is critical for compliance; your agent can check if the request falls under 'EMEA' before proceeding, ensuring regional rules are followed.

Search and retrieve specific asset metadata.

Use `search_assets` to locate content that matches a user query. The workflow takes the search term, executes the tool call, and then processes the resulting asset IDs using subsequent steps. If the initial search fails or returns ambiguous results, your agent can automatically retry with an adjusted query.

Manage all Showpad content tags in sequence.

`list_tags` pulls every classification tag used across Showpad. You build a process that first gathers the available tags and then uses them to filter subsequent asset searches, guaranteeing highly accurate results. The workflow can check multiple times: it runs `list_tags`, passes those tags to `search_assets`, and finally validates the resulting IDs using `get_asset_details`.

Setup guide

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

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

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

Mastra handles failures gracefully. If `search_assets` throws an error or times out, your workflow can automatically retry the query with exponential backoff until a valid result is returned.

You first call `list_users` to get the full directory. The workflow then checks if the required user exists, and if so, it calls `get_user_details` to pull specific profile data needed for the next step.

Yes. You can trigger steps based on channel availability. The process starts by calling `list_channels`, and then subsequent steps only proceed if the required channel ID is present.

Run a sequence: 1) Call `list_assets` to get IDs. 2) Pass those IDs one by one to `get_asset_details`. This verifies the current metadata and ensures compliance across the board.

The server touches user profile data (`get_user_details`) and asset metadata (via `list_assets`). Your workflows can be designed to only pass the minimum required data between steps.

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