How to Use the PHC GO MCP in Mastra AI

Q: How do I register the PHC GO MCP Server in my Mastra AI project?

Initialize the MCPClient using your Vinkius server URL and register it inside your Mastra configuration. From there, you can spread the client's tools directly into your agent's tool array. Mastra handles transport negotiation automatically.

Q: How do I set up human approval for PHC GO actions in Mastra AI?

Use Mastra's requireToolApproval option on sensitive write operations. When your agent attempts to execute createcustomer or createdocument, the workflow pauses and waits for a manual override. This prevents unauthorized database modifications.

Q: How do I check warehouse locations using this setup?

Call the listwarehouses tool within your Mastra workflow step to fetch active storage facilities. The agent can use this data to filter inventory levels retrieved by liststocks, allowing you to run localized stock checks.

Build resilient ERP workflows with Mastra AI and PHC GO to automate document generation with automatic retries.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect PHC GO MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Automate invoices with Mastra AI workflows

Automating commercial files like invoices and purchase orders is handled by the `create_document` tool. Mastra AI wraps this tool in a workflow that handles API rate limits using exponential backoff. If the ERP system returns a temporary error, the agent retries the call automatically without crashing the execution. You can configure conditional branches that check the output of `list_series` before initiating the document inside your automated MCP Server pipelines. If the target numbering series is closed, the workflow routes the task to a backup series. This ensures your billing pipeline never stalls due to configuration mismatches.

Verify ERP customer creation safely

Registering new clients and business entities directly in your database is the job of the `create_customer` tool. Mastra AI's human-in-the-loop system pauses the workflow before this tool executes, sending a validation request to your admin panel. Once approved, the agent proceeds to write the record. To prevent duplicates, the workflow runs `search_customers` using the client's tax number first. If a match is found, the agent skips creation and fetches details with `get_customer_details`. This guardrail keeps your customer database clean and accurate.

Trigger warehouse restocks via MCP Server

Physical storage locations are continuously monitored by the `list_stocks` tool. Mastra AI runs this tool on a cron schedule to evaluate stock levels for every product in your catalog. Whenever stock drops below your threshold, the workflow triggers an alert so you don't run out. The agent then calls `list_warehouses` to check alternative storage locations before drafting a transfer document. If stock is unavailable everywhere, the system automatically runs `create_document` to draft a supplier purchase order. This automates your supply chain without manual overhead.

Setup guide

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

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

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

Initialize the `MCPClient` using your Vinkius server URL and register it inside your Mastra configuration. From there, you can spread the client's tools directly into your agent's tool array. Mastra handles transport negotiation automatically.

Yes, it handles them using built-in workflow retry policies. If `create_document` fails due to network latency or ERP downtime, Mastra AI retries the operation with exponential backoff. You can also define fallback paths to notify your team via Slack.

Use Mastra's `requireToolApproval` option on sensitive write operations. When your agent attempts to execute `create_customer` or `create_document`, the workflow pauses and waits for a manual override. This prevents unauthorized database modifications.

Call the `list_warehouses` tool within your Mastra workflow step to fetch active storage facilities. The agent can use this data to filter inventory levels retrieved by `list_stocks`, allowing you to run localized stock checks.

Your ERP data, comprising warehouse configurations, stock balances, and client financial histories, flows directly between the secure Vinkius server and your Mastra hosting environment. Vinkius secures this channel using single-token authorization and ephemeral sandboxes.

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