Repository avatar
Other Tools
v1.0.0
active

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:

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

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:

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.

Remote