Omie ERP MCP Server for Windsurf 16 tools — connect in under 2 minutes
Windsurf brings agentic AI coding to a purpose-built IDE. Connect Omie ERP through the Vinkius and Cascade will auto-discover every tool — ask questions, generate code, and act on live data without leaving your editor.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install Omie ERP and 2,500+ MCP Servers from a single visual interface.
{
"mcpServers": {
"omie-erp": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}
* 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.
Windsurf's Cascade agent chains multiple Omie ERP tool calls autonomously — query data, analyze results, and generate code in a single agentic session. Paste the Vinkius Edge URL, reload, and all 16 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
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 Windsurf 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 Windsurf via MCP
Follow these steps to integrate the Omie ERP MCP Server with Windsurf.
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Add the server
Paste the JSON configuration above into mcp_config.json
Save and reload
Windsurf will detect the new server automatically
Start using Omie ERP
Open Cascade and ask: "Using Omie ERP, help me..." — 16 tools available
Why Use Windsurf with the Omie ERP MCP Server
Windsurf provides unique advantages when paired with Omie ERP through the Model Context Protocol.
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
Purpose-built for agentic workflows — Cascade understands context across your entire codebase and integrates MCP tools natively
JSON-based configuration means zero code changes: paste a URL, reload, and all 16 tools are immediately available
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
Omie ERP + Windsurf Use Cases
Practical scenarios where Windsurf combined with the Omie ERP MCP Server delivers measurable value.
Automated code generation: ask Cascade to fetch data from Omie ERP and generate models, types, or handlers based on real API responses
Live debugging: query Omie ERP tools mid-session to inspect production data while debugging without leaving the editor
Documentation generation: pull schema information from Omie ERP and have Cascade generate comprehensive API docs automatically
Rapid prototyping: combine Omie ERP data with Cascade's code generation to scaffold entire features in minutes
Omie ERP MCP Tools for Windsurf (16)
These 16 tools become available when you connect Omie ERP to Windsurf 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 Windsurf
Ready-to-use prompts you can give your Windsurf 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 Windsurf
Common issues when connecting Omie ERP to Windsurf through the Vinkius, and how to resolve them.
Server not connecting
Omie ERP + Windsurf FAQ
Common questions about integrating Omie ERP MCP Server with Windsurf.
How does Windsurf discover MCP tools?
mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.Can Cascade chain multiple MCP tool calls?
Does Windsurf support multiple MCP servers?
mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.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 Windsurf
Get your token, paste the configuration, and start using 16 tools in under 2 minutes. No API key management needed.