How to Use the Celoxis MCP in Mastra AI
Wire up Celoxis to Mastra AI and build resilient workflows that handle project risks and approvals with automatic retries.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Celoxis MCP to Mastra AI
Create your Vinkius account to connect Celoxis 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.
Automate Celoxis Risk Management
Fetching `list_risks` and `list_issues` exposes organizational blockers natively bounded within the custom application matrix. Mastra AI takes these outputs and evaluates them using built-in conditional branching. High-priority items trigger immediate escalation paths while minor bugs get logged for later review. Multi-step processes using `list_issues` require rock-solid error handling. If the API times out during a heavy query, the framework applies exponential backoff automatically. That agent keeps trying until the blocked issues map correctly to the workflow.
Route Timesheet Approvals in Mastra AI
Processing `list_approvals` alongside `list_time_entries` gives your system explicit tracking objects for pending constraints. Architects configure a sequence where the agent checks logged hours against task requirements before making a decision. Failures in logic route to a human-in-the-loop approval step. Managing billable hours with `list_expenses` demands precision. Raw `list_expenses` tool outputs feed raw accounting data into your pipeline for validation. Deploying this logic to any cloud takes a single command once your logic is set.
Sync Resources Across Portfolios
Combining `list_clients` with `list_portfolios` maps top-level CRM organizations to their strategic global tracking counterparts. Workflows can iterate through these portfolios to verify alignment across the business. State management happens behind the scenes automatically. Querying `list_resources` parses core user allocations handling the actual work. Autonomous scripts cross-reference these working resources against client demands on a schedule. Resource overallocation triggers a notification sequence directly to project managers.
Set up Celoxis MCP in Mastra AI
Prerequisites
- Node.js 18+ and a TypeScript project
-
@mastra/mcp+@mastra/corepackages - Active Vinkius subscription with a valid endpoint token
- 1
Install dependencies
Run
npm install @mastra/mcp @mastra/coreplus your preferred model provider (e.g.@ai-sdk/openai). - 2
Configure the MCPClient
Create an
MCPClientwith your Vinkius endpoint as aURLobject. 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'stoolsobject. All Celoxis tools become native Mastra tools. - 4
Run with any model
Swap
openai("gpt-4o")for any AI SDK-compatible provider. Callagent.generate()and the agent routes tool calls through MCP automatically.
import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";
const mcpClient = new MCPClient({
id: "celoxis-mcp-client",
servers: {
"celoxis-mcp": {
url: new URL(
"https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
),
},
},
});
const agent = new Agent({
name: "Celoxis Agent",
model: openai("gpt-4o"),
instructions: "You have access to Celoxis tools.",
tools: {
...(await mcpClient.listTools()),
},
});
const result = await agent.generate(
"List recent Celoxis transactions"
);
console.log(result.text); Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Celoxis. 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.
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 Celoxis MCP in Mastra AI
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Celoxis MCP today
We host it, we monitor it, we maintain it. You just paste one token.