Omie ERP MCP Server for Vercel AI SDK 16 tools — connect in under 2 minutes
The Vercel AI SDK is the TypeScript toolkit for building AI-powered applications. Connect Omie ERP through the Vinkius and every tool is available as a typed function — ready for React Server Components, API routes, or any Node.js backend.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import { createMCPClient } from "@ai-sdk/mcp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
async function main() {
const mcpClient = await createMCPClient({
transport: {
type: "http",
// Your Vinkius token — get it at cloud.vinkius.com
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
});
try {
const tools = await mcpClient.tools();
const { text } = await generateText({
model: openai("gpt-4o"),
tools,
prompt: "Using Omie ERP, list all available capabilities.",
});
console.log(text);
} finally {
await mcpClient.close();
}
}
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.
The Vercel AI SDK gives every Omie ERP tool full TypeScript type inference, IDE autocomplete, and compile-time error checking. Connect 16 tools through the Vinkius and stream results progressively to React, Svelte, or Vue components — works on Edge Functions, Cloudflare Workers, and any Node.js runtime.
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 Vercel AI SDK 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 Vercel AI SDK via MCP
Follow these steps to integrate the Omie ERP MCP Server with Vercel AI SDK.
Install dependencies
Run npm install @ai-sdk/mcp ai @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the script
Save to agent.ts and run with npx tsx agent.ts
Explore tools
The SDK discovers 16 tools from Omie ERP and passes them to the LLM
Why Use Vercel AI SDK with the Omie ERP MCP Server
Vercel AI SDK provides unique advantages when paired with Omie ERP through the Model Context Protocol.
TypeScript-first: every MCP tool gets full type inference, IDE autocomplete, and compile-time error checking out of the box
Framework-agnostic core works with Next.js, Nuxt, SvelteKit, or any Node.js runtime — same Omie ERP integration everywhere
Built-in streaming UI primitives let you display Omie ERP tool results progressively in React, Svelte, or Vue components
Edge-compatible: the AI SDK runs on Vercel Edge Functions, Cloudflare Workers, and other edge runtimes for minimal latency
Omie ERP + Vercel AI SDK Use Cases
Practical scenarios where Vercel AI SDK combined with the Omie ERP MCP Server delivers measurable value.
AI-powered web apps: build dashboards that query Omie ERP in real-time and stream results to the UI with zero loading states
API backends: create serverless endpoints that orchestrate Omie ERP tools and return structured JSON responses to any frontend
Chatbots with tool use: embed Omie ERP capabilities into conversational interfaces with streaming responses and tool call visibility
Internal tools: build admin panels where team members interact with Omie ERP through natural language queries
Omie ERP MCP Tools for Vercel AI SDK (16)
These 16 tools become available when you connect Omie ERP to Vercel AI SDK 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 Vercel AI SDK
Ready-to-use prompts you can give your Vercel AI SDK 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 Vercel AI SDK
Common issues when connecting Omie ERP to Vercel AI SDK through the Vinkius, and how to resolve them.
createMCPClient is not a function
npm install @ai-sdk/mcpOmie ERP + Vercel AI SDK FAQ
Common questions about integrating Omie ERP MCP Server with Vercel AI SDK.
How does the Vercel AI SDK connect to MCP servers?
createMCPClient from @ai-sdk/mcp and pass the server URL. The SDK discovers all tools and provides typed TypeScript interfaces for each one.Can I use MCP tools in Edge Functions?
Does it support streaming tool results?
useChat and streamText that handle tool calls and display results progressively in the UI.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 Vercel AI SDK
Get your token, paste the configuration, and start using 16 tools in under 2 minutes. No API key management needed.