OpulentAggro — MCP Server de STO Interempresas
OpulentiaAI/opulentaggro
41 ferramentas MCP para STO, faturamento IC e clearing interempresas no ERPNext
Ver no GitHubMCP server especializado em Transferências de Estoque (STO) interempresas para ERPNext, com suporte a faturamento IC, clearing de tesouraria, vendas triangulares e accruals. Integra-se via Vercel (gateway SSE) e stdio, fornecendo 41 ferramentas para automação de fluxos comerciais complexos em agronegócio.
Instalação
npx convez-ai OpulentiaAI/opulentaggro1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de Transferências de Estoque (STO) entre subsidiárias
- Faturamento intercompany (IC) com three-way matching e accruals
- Clearing de tesouraria e reconciliação triangular
- Integração Cursor/Claude com ERPNext via MCP para decisões comerciais
Veredito

Solução especializada e bem-arquitetada para operações interempresas complexas em ERPNext. Exige conhecimento profundo de STO, IC billing e MCP; não é apropriada para casos simples de ERP, mas é robusta para agronegócios multi-entidade.
README
A tradução para o português deste README ainda está na fila.
OpulentAggro Intercompany STO
ERPNext fork + MCP server + Vercel desk for AgroFresh-style intercompany Stock Transfer Orders, IC billing, treasury clearing, triangular sales, and accruals.
Architecture
flowchart TB
subgraph agents [Agents]
Cursor[Cursor / Cloud Agent]
end
subgraph gateway [Vercel]
UI["/app/* desk"]
MCP["/api/mcp SSE"]
API["/api/sto /api/ic"]
end
subgraph backend [Railway]
ERP[ERPNext whitelisted APIs]
end
Cursor --> MCP
Cursor -->|stdio| MCPlocal[erpnext-mcp-server]
MCPlocal --> ERP
MCP --> ERP
API --> ERP
UI --> API
Full flow map: docs/opulentaggro-flow-coverage.mdx
Agent skills
Skills follow Letta creating-skills and converting-mcps-to-skills patterns (progressive disclosure, MCP call → verify UI).
| Skill | Path | Purpose |
|---|---|---|
| opulentaggro-sto-mcp | .cursor/skills/opulentaggro-sto-mcp/ | Primary — 41 MCP tools, schemas, transports, workflows |
| opulentaggro-mcp-ui-e2e | .cursor/skills/opulentaggro-mcp-ui-e2e/ | MCP + UI test harness, screenshots, env loading |
| opulentaggro-sto-navigation | .cursor/skills/opulentaggro-sto-navigation/ | Desk routes, STO stages, Frappe REST |
| opulentaggro-vercel | .cursor/skills/opulentaggro-vercel/ | Vercel deploy, API proxies |
| mcp-db-alignment | .cursor/skills/mcp-db-alignment/ | Tool registry SSOT, seed parity |
| erpnext-sto-mcp | .cursor/skills/erpnext-sto-mcp/ | Alias → opulentaggro-sto-mcp |
| mcp-e2e-testing | .cursor/skills/mcp-e2e-testing/ | Alias → opulentaggro-mcp-ui-e2e |
Agent instructions: AGENTS.md
MCP (41 tools)
| Group | Count | Examples |
|---|---|---|
sto_* | 16 | sto_create, sto_three_way_match, sto_open_dispute |
ic_* billing | 6 | ic_create_invoice_pair, ic_submit_invoice |
ic_* extended | 8 | ic_match_and_clear, ic_triangular_sale, ic_create_accrual |
| Generic | 11 | get_document, call_method |
| Transport | Endpoint | Auth |
|---|---|---|
| Stdio | erpnext-mcp-server/build/index.js | ERPNEXT_API_KEY+SECRET or ERPNEXT_NO_AUTH=1 (local) |
| Vercel SSE | /api/mcp | Server-side API token; optional MCP_AUTH_TOKEN |
Env vars: ERPNEXT_URL, ERPNEXT_API_KEY, ERPNEXT_API_SECRET, MCP_AUTH_TOKEN, VERCEL_MCP_URL. Templates: config/demo-credentials.env.example, config/cloud-agent-remote.env.example.
Quick start — local MCP + UI test
cp config/demo-credentials.env.example config/demo-credentials.env
bash -lc 'source scripts/load_env.sh && ./scripts/start_all.sh && cd erpnext-mcp-server && npm run build && cd .. && ./scripts/verify_mcp_alignment.sh && ERPNEXT_NO_AUTH=1 python3 scripts/test_all_41_mcp_tools.py && ./scripts/test_local_mcp_ui_screenshots.sh'
- ERPNext:
http://localhost:8000 - Vercel:
http://localhost:3000 - MCP:
http://localhost:3000/api/mcp
Hosted stack
| Interface | URL |
|---|---|
| Vercel desk | https://vercel-indol-phi-69.vercel.app |
| Vercel MCP | https://vercel-indol-phi-69.vercel.app/api/mcp |
| Railway ERPNext | https://erpnext-production-512a.up.railway.app |
Latest validation: docs/local-mcp-ui-validation-report.md (33/33 PASS local).
Repo layout
| Path | Purpose |
|---|---|
erpnext/ | ERPNext fork (STO module, Pierre theme) |
erpnext-mcp-server/ | MCP server (41 tools) |
vercel/ | Next.js desk + API gateway |
docs/ | Setup, flow coverage, validation reports |
scripts/ | Seed, E2E, alignment |
Docs
- docs/opulentaggro-flow-coverage.mdx — AgroFresh flows → MCP → UI
- docs/erpnext-sto-mcp-setup.md — MCP + desk setup
- docs/cloud-agent-mcp-browser-runbook.md — Hosted validation