4,000+ servers built on MCP Fusion
Vinkius
Pydantic AISDK
Pydantic AI
Why use Omie ERP MCP Server with Pydantic AI?

Bring Business Management
to Pydantic AI

Create your Vinkius account to connect Omie ERP to Pydantic AI 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.

MCP Inspector GDPR Free for Subscribers
Create ClientCreate ProductCreate Sales OrderGet ClientGet ProductGet Sales OrderGet Stock SummaryList Accounts PayableList Accounts ReceivableList Bank AccountsList ClientsList ProductsList Sales OrdersList ServicesList StockUpdate Client
ChatGPT Claude Perplexity

Compatible with every major AI agent and IDE

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
Omie ERP

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

  1. Subscribe to this server
  2. Enter your Omie App Key and App Secret from the developer portal
  3. 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)

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

Why Pydantic AI?

Pydantic AI validates every Omie ERP tool response against typed schemas, catching data inconsistencies at build time. Connect 16 tools through Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code. full type safety, structured output guarantees, and dependency injection for testable agents.

  • Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application

  • Model-agnostic architecture. switch between OpenAI, Anthropic, or Gemini without changing your Omie ERP integration code

  • Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors

  • Dependency injection system cleanly separates your Omie ERP connection logic from agent behavior for testable, maintainable code

P
See it in action

Omie ERP in Pydantic AI

AI AgentVinkius
High Security·Kill Switch·Plug and Play
Enterprise Security

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.

View full Omie ERP details →
Omie ERP
Fully ManagedNo server setup
Plug & PlayNo coding needed
SecurePrivacy protected
PrivateYour data is safe
Cost ControlBudget limits
Control1-click disconnect
Auto-UpdatesMaintenance free
High SpeedOptimized for AI
Reliable99.9% uptime
Your credentials and connection tokens are fully encrypted

* 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

01 / Catalog

Over 4,000 integrations ready for AI agents

Explore a vast library of pre-built integrations, optimized and ready to deploy.

02 / Credentials

Connect securely in under 30 seconds

Generate tokens to authenticate and link external services in a single step.

03 / Guardian

Complete visibility into every agent action

Audit live requests, latency, success rates, and active security compliance policies.

04 / FinOps

Optimize spending and track token ROI

Analyze real-time token consumption and cost metrics detailed by connection.

Over 4,000 integrations ready for AI agents
Connect securely in under 30 seconds
Complete visibility into every agent action
Optimize spending and track token ROI

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.

Why Vinkius

Omie ERP and 4,000+ other AI tools. No hosting, no code, ready to use.

Professionals who connect Omie ERP to Pydantic AI 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.

4,000+MCP Integrations
<40msResponse time
100%Fully managed
Raw MCP
Vinkius
Ready-to-use MCPsFind and configure each manually4,000+ MCPs ready to use
Connection SetupManual coding & server setup1-click instant connection
Server HostingYou host it yourself (needs 24/7 uptime)100% hosted & managed by Vinkius
Security & PrivacyStored in plaintext config filesBank-grade encrypted vault
Activity VisibilityBlind execution (no logs or tracking)Live dashboard with real-time logs
Cost ControlRunaway AI token spend riskAutomatic budget limits
Revoking AccessMust delete files or code to stop1-click disconnect button
The Vinkius Advantage

How Vinkius secures Omie ERP for Pydantic AI

Every request between Pydantic AI 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.

< 40msCold start
Ed25519Signed audit chain
60%Token savings
FAQ

Frequently asked questions

01

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.

02

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.

03

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.

04

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.

05

How does Pydantic AI discover MCP tools?

Create an MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.

06

Does Pydantic AI validate MCP tool responses?

Yes. When you define result types as Pydantic models, every tool response is validated against the schema. Invalid data raises a clear error instead of silently corrupting your pipeline.

07

Can I switch LLM providers without changing MCP code?

Absolutely. Pydantic AI abstracts the model layer. your Omie ERP MCP integration works identically with OpenAI, Anthropic, Google, or any supported provider.

08

MCPServerHTTP not found

Update: pip install --upgrade pydantic-ai

Explore More MCP Servers

View all →