Celoxis MCP Server for Mastra AI 12 tools — connect in under 2 minutes
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Celoxis through the Vinkius and Mastra agents discover all tools automatically — type-safe, streaming-ready, and deployable anywhere Node.js runs.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token — get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"celoxis": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Celoxis Agent",
instructions:
"You help users interact with Celoxis " +
"using 12 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Celoxis?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Celoxis MCP Server
Connect your Celoxis enterprise platform to any AI agent and take full control of your Project Portfolio Management (PPM) workflow through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Celoxis tool infrastructure. Connect 12 tools through the Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution — deployable to any Node.js host in one command.
What you can do
- Project & Portfolio Mapping — List strategic portfolios and extract granular project structures including absolute timelines, completion statuses, and mapped budget blocks.
- WBS & Tasks — Retrieve explicit Work Breakdown Structure nodes, identifying active assignments, task health, and explicit phase deliverables.
- Resource Allocation — Evaluate working resources, parse user mappings, and expose global scheduling types and distinct system roles across your organization.
- Timesheets & Accounting — Accurately pull time entries logged by members to measure billable matrices and ledger associations tied directly to tasks natively.
- Issue & Risk Governance — Poll blocking issues preventing workflows and assess graded severity impacts modeled inside the Celoxis organizational risk matrix.
- Approvals Pipeline — Interrogate pending validations routing over timesheets, assessing gating rules and internal clearance statuses immediately.
The Celoxis MCP Server exposes 12 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect Celoxis to Mastra AI via MCP
Follow these steps to integrate the Celoxis MCP Server with Mastra AI.
Install dependencies
Run npm install @mastra/core @mastra/mcp @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the agent
Save to agent.ts and run with npx tsx agent.ts
Explore tools
Mastra discovers 12 tools from Celoxis via MCP
Why Use Mastra AI with the Celoxis MCP Server
Mastra AI provides unique advantages when paired with Celoxis through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure — add Celoxis without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Celoxis tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host — Vercel, Railway, Fly.io, or your own infrastructure
Celoxis + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Celoxis MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Celoxis, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Celoxis as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Celoxis on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Celoxis tools alongside other MCP servers
Celoxis MCP Tools for Mastra AI (12)
These 12 tools become available when you connect Celoxis to Mastra AI via MCP:
get_project
Get an explicit Celoxis project and its complete intrinsic properties structure by ID
list_approvals
List explicit tracking objects identifying pending/cleared approvals over timesheets and expenses constraints
list_clients
List explicit top-level CRM organizational clients linked internally to distinct portfolios
list_expenses
List raw billable/non-billable expenses physically mapped onto task items inside the ecosystem
list_issues
List custom app items representing blocked issues explicit to complex workflows mapping problems
list_milestones
List raw milestones natively mapping absolute phase delivery tracking inside the WBS
list_portfolios
List strategic global tracking Portfolios mapping top-level aggregates over child projects natively
list_projects
List all top-level project portfolio items in Celoxis. Returns physical IDs, names, status, and timeline data
list_resources
List all explicit Celoxis working resources parsing the core user mappings handling allocations
list_risks
List explicit organizational risks bounded natively via the Celoxis custom application matrix
list_tasks
List comprehensive Work Breakdown Structure (WBS) tasks representing concrete deliverables within active projects
list_time_entries
List actual time entries logged explicitly against Celoxis tasks or projects for accounting
Example Prompts for Celoxis in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Celoxis immediately.
"List all active projects in our company portfolio and check their timeline status."
"Check the detailed logged time entries for the Marketing project and verify pending approvals."
"Extract the explicit risk logs and blocked issues reported across our client portfolio."
Troubleshooting Celoxis MCP Server with Mastra AI
Common issues when connecting Celoxis to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpCeloxis + Mastra AI FAQ
Common questions about integrating Celoxis MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Connect Celoxis with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect Celoxis to Mastra AI
Get your token, paste the configuration, and start using 12 tools in under 2 minutes. No API key management needed.