How to Use the Cincopa MCP in Mastra AI

Q: How do I connect Mastra AI to my Cincopa account?

You install the @mastra/mcp package and configure a new MCPClient with the Vinkius URL for your Cincopa MCP server. Mastra automatically discovers the available tools like listcincopaassets for you to use in your agents.

Q: Can a Mastra AI agent manage Cincopa gallery templates?

Yes. The agent can call listcincopatemplates to see all available options. Your workflow logic can then pick a template ID based on file type or other criteria and pass it to the createnewgallery tool.

Build resilient, automated media workflows for Cincopa with Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cincopa MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Media Ingestion Pipelines

A Mastra AI workflow can start by getting a temporary URL with `get_media_upload_url`. After your system uploads a file, the agent uses `get_asset_metadata` to check that the asset was processed correctly in Cincopa. Here's where Mastra shines. If the metadata check fails, its workflow engine can automatically retry the check. If it still fails, the agent can use `delete_media_asset` to clean up the broken file and send a notification. That's a truly robust pipeline.

Build Conditional Content Workflows

Mastra's power is in its conditional logic. You can build an agent that first calls `list_cincopa_galleries`. If a specific 'Weekly Highlights' gallery doesn't exist, the agent can automatically create it using `create_new_gallery`. This lets you build self-healing systems. Your agent isn't just executing commands; it's making decisions based on the state of your Cincopa account. It checks, then acts, all through the same MCP connection.

Add Human-in-the-Loop Approvals

Not every action should be fully automated. You can create a workflow where an agent uploads a new video, but then pauses the entire process using Mastra's `requireToolApproval` feature. This sends a request for a human to sign off. Only after you approve it will the agent proceed to the next step, like adding the asset to a public-facing gallery. It's automation with a safety net.

Setup guide

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

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

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

You install the `@mastra/mcp` package and configure a new `MCPClient` with the Vinkius URL for your Cincopa MCP server. Mastra automatically discovers the available tools like `list_cincopa_assets` for you to use in your agents.

Yes. The agent can call `list_cincopa_templates` to see all available options. Your workflow logic can then pick a template ID based on file type or other criteria and pass it to the `create_new_gallery` tool.

Definitely. You can deploy a Mastra AI workflow that runs on a schedule. The agent could use `list_cincopa_assets` to find old or unused media, then use `delete_media_asset` to remove them, freeing up storage.

Mastra has built-in automatic retries with exponential backoff. If a call to a Cincopa tool fails due to a temporary network issue, Mastra will try again. You can configure this behavior or add custom error handling logic to your workflow.

The agent works with your Cincopa media asset metadata, gallery lists, and template information. All data is processed within your Mastra AI deployment and the ephemeral Vinkius sandbox. Your Cincopa credentials are never part of your agent's code.

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