How to Use the Scoro MCP in Mastra AI

Q: Can Mastra AI automatically assign Scoro tasks to users?

Yes. Mastra AI can query listusers and listtasks to check workloads, then use its workflow engine to decide which team member should take the new assignment.

Build automated, resilient billing and project workflows in Mastra AI using direct Scoro data integration.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Scoro MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Build resilient Scoro billing loops using our MCP Server

The `list_invoices` tool allows your Mastra AI agent to audit open sales records against your actual expenses. If the agent detects a discrepancy, Mastra's workflow engine can trigger a retry loop or flag the invoice for manual review. You can pair this with `list_expenses` to automatically calculate project profitability. The workflow handles API hiccups gracefully using Mastra's built-in exponential backoff, ensuring your financial audits never fail halfway through.

Automate task assignments based on calendar data via the MCP Server

The `list_calendar_events` tool exposes your team's real-time availability directly to Mastra's decision engine via the MCP Server. Your agent checks this calendar data alongside `list_tasks` to assign incoming work to the least busy team member. If a team member is overbooked, Mastra's conditional branching routes the task to an alternative user found via `list_users`. This keeps your operations moving without manual project manager intervention.

Track sales quotes through automated pipelines

The `list_quotes` tool feeds your active sales pipeline directly into Mastra AI's background workers. The agent scans these quotes daily to identify deals nearing their close dates and matches them with existing account histories. By calling `list_contacts` on matched deals, the agent can draft personalized follow-up emails in your background queue. Mastra's workflow engine ensures these drafts are saved and ready for your sales team to review.

Setup guide

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

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

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

Instantiate the client using our MCP Server in your Mastra AI codebase and point it to your Vinkius endpoint. The agent automatically registers tools like `list_projects` to start managing your workspace.

Yes. Mastra AI can query `list_users` and `list_tasks` to check workloads, then use its workflow engine to decide which team member should take the new assignment.

Mastra AI uses its native workflow engine to queue tasks. If a call to `list_time_entries` triggers a rate limit, the framework automatically pauses and retries using exponential backoff.

No. The MCP Server handles the raw API mapping, exposing tools like `list_activities` directly to Mastra AI. You only write the agent logic and workflow conditions.

Your sensitive client lists and financial estimates are secure. Vinkius processes all requests to the MCP Server inside an isolated V8 sandbox, passing the data directly to your Mastra agent without storing it on disk.

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