ssotica-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP ssOtica
Servidor MCP local em Python para as seis APIs consultivas documentadas do ssOtica. Faz somente requisições GET, autentica com Bearer Token, pagina automaticamente quando a API informa páginas e salva cada consulta em CSV UTF-8, com objetos aninhados em colunas com ponto.
Instalação
Use Python 3.10 ou posterior.
cd mcp
python3.12 -m venv .venv-mcp
source .venv-mcp/bin/activate
pip install -r requirements.txt
cp .env.example .envEdite .env e informe SSOTICA_TOKEN (Bearer Token enviado pelo ssOtica). Os seis endpoints já vêm configurados.
Variável | Descrição |
| Token enviado em |
| URL base ( |
| Vendas ativas. |
| Ordens de serviço. |
| Extrato/lançamentos financeiros. |
| Produtos, estoque, reservas, preços e fornecedores. |
| Contas a pagar. |
| Contas a receber. |
Related MCP server: omie-mcp
Registrar no Cursor
Em Settings → MCP → Add new MCP server, ou em .cursor/mcp.json:
{
"mcpServers": {
"ssotica": {
"command": "~/mcp/.venv-mcp/bin/python",
"args": ["~/mcp/mcp_server.py"]
}
}
}Tools disponíveis
Todas recebem empresa. O servidor aceita CNPJ sem pontuação ou Código da Licença e resolve automaticamente via data/empresas.csv. Se uma API da ssOtica aceitar somente CNPJ e esse CNPJ tiver várias licenças, o servidor consulta o CNPJ normalmente e salva o resultado agregado do conjunto.
Tool | API | Identificador | Período |
| Lista local | — | — |
| Vendas ativas | CNPJ | máx. 30 dias |
| Ordens de serviço | CNPJ | máx. 30 dias |
| Extrato financeiro | CNPJ | máx. 30 dias |
| Produtos/estoque | Código da Licença | — |
| Contas a pagar | Código da Licença | sem limite de 30 dias |
| Contas a receber | Código da Licença | sem limite de 30 dias |
Argumentos opcionais:
Período:
data_inicio,data_fim(YYYY-MM-DD; padrão: mês atual até hoje)Desambiguação:
licenca(usada nas APIs que aceitam Código da Licença)Produtos:
referencia,produto_id,page,per_page(máx. 100)Contas a pagar:
tipo_periodo(vencimento,cancelamento,pagamento,lançamento,emissao),conta_id,documento,emissao,page,per_pageContas a receber:
tipo_periodo(vencimento,cancelamento,pagamento,lançamento,renegociacao),conta_id,documento,renegociacao,page,per_page
Com conta_id, os demais filtros de período são ignorados (conforme documentação da API).
Exemplos:
consultar-vendas-ativas empresa=42547637000142 licenca=RODO-UYEN data_inicio=2026-07-01 data_fim=2026-07-10
consultar-produtos-estoque empresa=42547637000142 licenca=RODO-UYEN referencia=ABC-123
consultar-contas-pagar empresa=RODO-UYEN tipo_periodo=pagamento data_inicio=2025-08-01 data_fim=2025-08-31Arquivos gerados
CSVs em data/, organizados por tipo: vendas/, ordens_servico/, lancamentos_financeiros/, produtos_estoque/, contas_pagar/ e contas_receber/.
Solução de problemas
401 / 403: token inválido, expirado ou sem permissão.
404: confirme se a conta possui acesso à API consultiva contratada.
Período inválido: vendas, O.S. e extrato aceitam no máximo 30 dias por consulta.
CNPJ com várias licenças em API somente por CNPJ: a consulta retorna o agregado do CNPJ; a API ssOtica não retorna a licença nos registros para separar as unidades.
Sem resultados: é gerado um CSV com cabeçalho; revise identificador, período e filtros.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for Brazilian Federal Senate open data (legislative, administrative, e-Cidadania).
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
MCP server for querying and analyzing data from ad platforms, analytics tools, and spreadsheets
MCP server for the Seline Analytics API
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server providing business tools for customer support and account management, integrated with SQLite, OpenAI, and Streamlit.-
- AlicenseNot gradedqualityDmaintenanceMCP server for the Omie API to list products, consult clients, and create budgets19 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server for Bling ERP, enabling read and write operations on sales orders, products, contacts, accounts payable/receivable, NF-e, inventory, and more via OAuth 2.0.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for ConnectPlug's API enabling read-only querying of sales, inventory, financial data, DRE, and orders from iFood, Rappi, and Uber Eats for restaurants and retail.MIT