How to Use the Stark Bank MCP in Mastra AI

Q: What kind of data does the Stark Bank API expose for card management in mastra-ai?

You can use starkcreatecorporatecard to generate new cards on the fly. The framework integrates this action into a larger workflow, treating the card creation as just another step that must pass before proceeding with expense tracking.

Q: Does mastra-ai support integrating Stark Bank's statement data?

Yes. By calling starkgetstatement, your agent pulls a raw, detailed cash flow report. This structured data is perfect for feeding into downstream accounting systems that require granular transaction records.

Build mission-critical finance pipelines using Stark Bank's payment rails, designed for the mastra-ai framework.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Stark Bank MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Automate complex receivables and payables.

The `stark_create_boleto` tool lets you programmatically issue batches of official bank slips. Your agent can handle the required parameters (value, due date) and build out entire payment schedules that adhere to specific business rules. This is vital for managing predictable cash inflows. You'll use this alongside `stark_list_boletos` to track every billing item’s status, ensuring no receivable falls through the cracks in your complex workflow.

Handle immediate and scheduled payouts.

When you need instant payments or payroll runs, use `stark_create_pix_charge` for dynamic Pix billing. The agent can manage this charge instantly, making it ideal for real-time transactions. For larger, planned disbursements (like vendor payments), the `stark_create_transfer` tool handles both TED and Pix payouts. This allows your multi-step workflow to initiate funds movement reliably, even if a payment needs retrying with exponential backoff.

Maintain real-time financial visibility.

The `stark_get_balance` function pulls the current liquid cash total from your bank account. Your system can check this balance at any point in a workflow—say, before initiating a large payment—to prevent overdraft errors. If you need a deep dive into historical movement, call `stark_get_statement`. This gives you a raw, detailed statement of the cash flow, which is necessary for auditing and verifying that your automated processes are accurate.

Setup guide

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

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

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

The agent framework automatically retries failed transactions. You can configure it with exponential backoff, so if a transfer fails due to temporary network issues, it waits and tries again, minimizing manual intervention for Stark Bank payments.

Absolutely. It supports conditional branching, letting you decide whether a payment needs a Pix charge (`stark_create_pix_charge`) or if it should be processed as a standard transfer based on external rules.

You can use `stark_create_corporate_card` to generate new cards on the fly. The framework integrates this action into a larger workflow, treating the card creation as just another step that must pass before proceeding with expense tracking.

Yes. By calling `stark_get_statement`, your agent pulls a raw, detailed cash flow report. This structured data is perfect for feeding into downstream accounting systems that require granular transaction records.

The system handles core payment and liquidity data, including Boleto details (`stark_list_boletos`), Pix charge history (`stark_list_pix_charges`), and all outgoing transfer records (`stark_list_transfers`).

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