
moedux
io.github.jhonnysabino/moedux
Diagnóstico de Mar Vermelho e projeção de saldo em 12 meses, sem cadastro, com link pré-preenchido.
Documentation
Moedux — ferramentas para agentes de IA
Moedux é um aplicativo brasileiro de finanças pessoais: transações, contas e estimativas de gasto viram um diagnóstico legível e uma próxima ação concreta.
Este repositório reúne os artefatos que um agente de IA precisa para usar o Moedux sem adivinhar formato de campo nem permissão de API. É um espelho público e versionado do que o próprio app publica em /developers.
Servidor MCP (registro oficial)
O Moedux publica um servidor MCP remoto (Streamable HTTP) no Registro Oficial de MCP, sem cadastro nem chave de API:
- Endpoint:
https://www.moedux.com/mcp - Registro:
io.github.jhonnysabino/moedux@1.0.0— https://registry.modelcontextprotocol.io/v0.1/servers/io.github.jhonnysabino%2Fmoedux/versions/1.0.0 - Server Card SEP-1649: https://www.moedux.com/.well-known/mcp.json
Ferramentas disponíveis:
prever_mar_vermelho— data prevista em que o saldo chega a zero (Mar Vermelho), com link pré-preenchido.projetar_saldo_12_meses— saldo projetado em 12 meses e a data do Mar Vermelho, com link pré-preenchido e citação da fonte.
Exemplo de configuração para um cliente MCP:
{
"mcpServers": {
"moedux": {
"type": "streamable-http",
"url": "https://www.moedux.com/mcp"
}
}
}
Contrato da API
- Especificação OpenAPI 3.1:
openapi.json— espelho de https://www.moedux.com/openapi.json - Documentação para humanos: https://www.moedux.com/developers?utm_source=github&utm_medium=repo&utm_campaign=agent-tools
- Autenticação: HTTP Bearer com API Key criada em Configurações > API Keys no app.
Cada operação carrega x-permission. Peça sempre a permissão mínima: diagnosis:read, transactions:read, transactions:write, scenarios:compare, scenarios:apply ou networth:read.
Skill do CLI
SKILL.md ensina um agente a instalar e usar o moedux-cli, o cliente oficial da API /api/v1 com entrada e saída JSON. Instalação:
curl -fsSL https://www.moedux.com/static/cli-install.sh | sh
O binário aceita diagnosis, transactions list|add|edit|remove, networth e scenarios compare|apply. A especificação em openapi.json é a fonte canônica quando houver divergência.
Começando sem cartão
O cadastro cria 14 dias de teste gratuito: https://www.moedux.com/app/login?utm_source=github&utm_medium=repo&utm_campaign=agent-tools
Guias de finanças pessoais
Conteúdo gratuito e independente, mantido no gist canônico do projeto:
- Guia prático de controle financeiro com modelos CSV
- Reserva de emergência: como montar e quanto guardar
- Comparativo de aplicativos de finanças pessoais
Atualização
Os arquivos deste repositório são gerados a partir do código do app. Para atualizar, copie cmd/moedux-cli/SKILL.md e o GET /openapi.json da versão publicada.
Moedux · Termos de uso · Privacidade
No installation packages available.