Omie ERP MCP Server for Mastra AI 16 tools — connect in under 2 minutes
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Omie ERP through 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: {
"omie-erp": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Omie ERP Agent",
instructions:
"You help users interact with Omie ERP " +
"using 16 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Omie ERP?"
);
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 Omie ERP MCP Server
Connect your Omie ERP account to any AI agent and take full control of your business management workflows through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Omie ERP tool infrastructure. Connect 16 tools through 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
- Client Management — List, create, update, and inspect clients (customers, suppliers) with full contact and tax information
- Product Catalog — Browse products and services, check details, create new items, and monitor stock levels
- Sales Orders — List, create, and inspect sales orders with line items, pricing, and payment terms
- Financial Monitoring — Track accounts receivable and payable to monitor cash flow and identify overdue items
- Bank Accounts — List configured bank accounts and check balances for financial reconciliations
- Inventory Control — Monitor stock levels, check product availability, and identify items needing reorder
- Services Catalog — List and manage non-physical services offered to clients
The Omie ERP MCP Server exposes 16 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 Omie ERP to Mastra AI via MCP
Follow these steps to integrate the Omie ERP 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 16 tools from Omie ERP via MCP
Why Use Mastra AI with the Omie ERP MCP Server
Mastra AI provides unique advantages when paired with Omie ERP through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Omie ERP 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 Omie ERP 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
Omie ERP + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Omie ERP MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Omie ERP, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Omie ERP as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Omie ERP on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Omie ERP tools alongside other MCP servers
Omie ERP MCP Tools for Mastra AI (16)
These 16 tools become available when you connect Omie ERP to Mastra AI via MCP:
create_client
You must provide at minimum the business name (razao_social) and CNPJ/CPF. Optional fields include trade name, address, contacts, email, phone, payment terms, and credit limits. The response includes the newly created client code which can be used for future references. Data must be provided as a JSON object matching Omie's client schema. Create a new client (customer/supplier) in Omie ERP
create_product
You must provide at minimum the product code (codigo_produto) and description. Optional fields include NCM, unit, cost price, sale price, stock quantity, and tax configuration. The response includes the newly created product details. Data must be provided as a JSON object matching Omie's product schema. Create a new product in Omie ERP
create_sales_order
You must provide the client code (codigo_cliente) and at least one line item with product code, quantity, and price. Optional fields include discounts, taxes, shipping info, and payment terms. The response includes the newly created order code. Data must be provided as JSON matching Omie's order schema. Create a new sales order (pedido de venda) in Omie ERP
get_client
Use the client_id (codigo_cliente) obtained from list_clients to inspect full client details. This is useful for verifying client data before creating orders or invoices. Get detailed information about a specific client
get_product
Use the product_code (codigo_produto) obtained from list_products to inspect full product details. This is useful for verifying product data before creating orders. Get detailed information about a specific product
get_sales_order
Use the order_id (codigo_pedido) obtained from list_sales_orders to inspect full order details. This is useful for verifying order data before invoicing. Get detailed information about a specific sales order
get_stock_summary
Use the product_code (codigo_produto) obtained from list_products to inspect stock details. This helps determine if a product is available for sale or needs reordering. Get stock summary for a specific product
list_accounts_payable
Each entry includes supplier, due date, amount, status (open, paid, overdue), and payment method. You can optionally specify page number and records per page. Use this to monitor outgoing payments and identify bills that are due or overdue. List all accounts payable (contas a pagar) in Omie ERP
list_accounts_receivable
Each entry includes client, due date, amount, status (open, paid, overdue), and payment method. You can optionally specify page number and records per page. Use this to monitor incoming payments and identify overdue invoices that need follow-up. List all accounts receivable (contas a receber) in Omie ERP
list_bank_accounts
Each account includes bank name, agency, account number, and current balance. Use this to verify which bank accounts are available for financial transactions and reconciliations. List all bank accounts (contas correntes) configured in Omie ERP
list_clients
Each client includes business name (razao_social), trade name (nome_fantasia), CNPJ/CPF, contact information, address, and client code. You can optionally specify page number and records per page (default: 50). Use this to browse your client database or find a specific client by name or document. List all clients (customers, suppliers) in Omie ERP
list_products
You can optionally specify page number and records per page (default: 50). Use this to browse your product catalog or find a specific product by code or description. List all products and services in Omie ERP
list_sales_orders
You can optionally specify page number and records per page. Use this to browse your sales pipeline or find a specific order by number or client. List all sales orders (pedidos de venda) in Omie ERP
list_services
Services are non-physical offerings sold to clients (consulting, maintenance, etc.). You can optionally specify page number and records per page. Use this to browse your service catalog. List all services (serviços) registered in Omie ERP
list_stock
Each entry includes product code, description, quantity in stock, minimum stock level, and warehouse location. You can optionally specify page number and records per page. Use this to monitor inventory levels and identify products that need reordering. List stock/inventory levels for all products in Omie ERP
update_client
You must provide the client_id (codigo_cliente) and the fields to update. Only the fields provided in client_data will be updated. This is useful for correcting client information, updating addresses, or changing payment terms. The client_id must exist in the system. Update an existing client in Omie ERP
Example Prompts for Omie ERP in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Omie ERP immediately.
"List all my clients and show me their total outstanding balances."
"Create a new sales order for client TechCorp with 5 units of product 'Consulting Hours' at R$ 150/hour."
"Show me all overdue accounts payable and the total amount owed."
Troubleshooting Omie ERP MCP Server with Mastra AI
Common issues when connecting Omie ERP to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpOmie ERP + Mastra AI FAQ
Common questions about integrating Omie ERP 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 Omie ERP 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 Omie ERP to Mastra AI
Get your token, paste the configuration, and start using 16 tools in under 2 minutes. No API key management needed.