Bring Business Management
to Windsurf
Create your Vinkius account to connect Omie ERP to Windsurf and start using all 16 AI tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code. No hosting, no server setup — just connect and start using.
Compatible with every major AI agent and IDE
What is the 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.
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
How it works
- Subscribe to this server
- Enter your Omie App Key and App Secret from the developer portal
- Start managing clients, products, orders, and finances from Claude, Cursor, or any MCP-compatible client
No more navigating the Omie dashboard for every data lookup. Your AI acts as a dedicated ERP assistant.
Who is this for?
- Business Owners — instantly check client details, product availability, and financial status without opening the ERP
- Sales Teams — create and inspect sales orders directly from conversations, verify pricing and stock levels
- Financial Managers — monitor accounts receivable/payable and identify overdue invoices or bills
- Operations Staff — check inventory levels, create clients, and manage product catalog efficiently
Built-in capabilities (16)
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
Why Windsurf?
Windsurf's Cascade agent chains multiple Omie ERP tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste 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.
- —
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 in Windsurf
Why run Omie ERP with Vinkius?
The Omie ERP connection runs on our fully managed, secure cloud infrastructure. We handle the hosting, maintenance, and security so you don't have to deal with servers or code. All 16 tools are ready to work instantly without any complex setup.
You stay in complete control of your data. Your AI only accesses the information you approve, keeping your sensitive passwords and private details completely safe. Plus, with automatic optimizations, your AI works faster and more efficiently.

* Every connection is hosted and maintained by Vinkius. We handle the security, updates, and infrastructure so you don't have to write code or manage servers. See our infrastructure
Over 4,000 integrations ready for AI agents
Explore a vast library of pre-built integrations, optimized and ready to deploy.
Connect securely in under 30 seconds
Generate tokens to authenticate and link external services in a single step.
Complete visibility into every agent action
Audit live requests, latency, success rates, and active security compliance policies.
Optimize spending and track token ROI
Analyze real-time token consumption and cost metrics detailed by connection.




Explore our live AI Agents Analytics dashboard to see it all working
This dashboard is included when you connect Omie ERP using Vinkius. You will never be left in the dark about what your AI agents are doing with your tools.
Omie ERP and 4,000+ other AI tools. No hosting, no code, ready to use.
Professionals who connect Omie ERP to Windsurf through Vinkius don't need to write code, manage servers, or worry about security. Everything is pre-configured, secure, and runs automatically in the background.
Raw MCP | Vinkius | |
|---|---|---|
| Ready-to-use MCPs | Find and configure each manually | 4,000+ MCPs ready to use |
| Connection Setup | Manual coding & server setup | 1-click instant connection |
| Server Hosting | You host it yourself (needs 24/7 uptime) | 100% hosted & managed by Vinkius |
| Security & Privacy | Stored in plaintext config files | Bank-grade encrypted vault |
| Activity Visibility | Blind execution (no logs or tracking) | Live dashboard with real-time logs |
| Cost Control | Runaway AI token spend risk | Automatic budget limits |
| Revoking Access | Must delete files or code to stop | 1-click disconnect button |
How Vinkius secures
Omie ERP for Windsurf
Every request between Windsurf and Omie ERP is protected by our secure gateway. We automatically keep your sensitive data private, prevent unauthorized access, and let you disconnect instantly at any time.
Frequently asked questions
How do I get Omie API credentials (App Key and App Secret)?
Log in to your Omie ERP account, go to Configurações > Aplicativos (Settings > Applications), and create a new application. Omie will automatically generate an App Key and App Secret for you. Copy both values immediately — the App Secret is shown only once. Paste them into the respective fields below. These credentials are used to authenticate all API requests.
Can I create new clients and products through this integration?
Yes! Use the create_client tool to add new clients (customers/suppliers) and create_product to add new products to your Omie catalog. You'll need to provide the data as JSON objects matching Omie's schema. The AI agent can help you structure the data correctly. After creation, you'll receive the new client or product code for future reference.
How can I monitor overdue invoices and payments?
Use list_accounts_receivable to see all money owed to your company, and list_accounts_payable to see all money you owe. Each entry includes the due date, amount, and status. You can filter and identify overdue items by comparing the due date with today's date. The AI agent can help you analyze the results and highlight which invoices need immediate attention.
What ERP modules are accessible through this API?
This integration covers the core Omie modules: Clients (customers, suppliers, transporters), Products & Services (catalog management), Sales Orders (pedidos de venda), Accounts Receivable (contas a receber), Accounts Payable (contas a pagar), Bank Accounts (contas correntes), and Inventory/Stock (estoque). Additional modules like NF-e, NFS-e, CRM, and purchases are available through Omie's full API but may be added in future updates.
How does Windsurf discover MCP tools?
Windsurf reads the 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?
Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.
Does Windsurf support multiple MCP servers?
Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.
Server not connecting
Check Settings → MCP for the server status. Try toggling it off and on.
Explore More MCP Servers
View all →
Transifex
10 toolsLocalize your projects efficiently using AI Agents with the official Transifex integration.

Zuora
10 toolsManage subscriptions, billing accounts, and unified orders on Zuora — the leading monetization platform for the subscription economy.

QuestDB (Time-Series)
4 toolsHigh-performance time-series database for fast SQL queries, data ingestion, and real-time analytics directly from your AI agent.

FantasyData (SportsDataIO)
12 toolsAccess real-time sports data via FantasyData (SportsDataIO) — track players, scores, and schedules for NFL, NBA, and MLB.
