Qotien — Fiscal & Retraite FR

← Qotien Qotien

O motor patrimonial francês, chamável

A Qotien expõe seu motor de cálculo — fiscalidade e aposentadoria 2026, com fontes e datas — para agentes de IA (Model Context Protocol) e desenvolvedores (API REST, aberta). Um número nunca vem sozinho: cada resposta carrega seu nível de confiança e suas fontes oficiais.

// o contrato de resposta (o diferencial)

Cada resultado é encapsulado da mesma forma — nunca um número nu:

{ "ok": true, "domaine": "retraite", "confiance": "fiable", // fiable · estime · partiel · non_calculable "result": { … }, "sources": ["Circulaire CNAV 2026-04", "…"], "millesime_fiscal": "2026", "avertissement": "…" }

A confiança é atribuída pelo motor (determinístico = fiable; estimativa enquadrada = estime), nunca assumida levianamente. É isso que torna o número citável por uma IA.

// endpoints

Endpoint	Uso
GET /api/fiscal/v1/manifest	Autodescrição: as ferramentas, seus esquemas, sua confiança padrão, plan_hints
GET /openapi.json	Spec OpenAPI 3.1 (gerada a partir do manifesto, à prova de drift): cada capacidade, seu esquema de entrada, o envelope de resposta. Para ferramentas/agentes que consomem um Swagger/OpenAPI.
POST /api/fiscal/v1/mcp	MCP JSON-RPC 2.0 (tools/list, tools/call) — para agentes de IA. GET com Accept: text/event-stream = canal SSE.
POST /api/fiscal/v1/calculate	API REST direta: { capability, input } → o contrato acima. CORS aberto.

Base: https://app.qotien.fr. Limitado por IP. A descoberta (manifesto, OpenAPI, tools/list) é gratuita; toda capacidade que entrega um fato é paga em x402 (veja abaixo).

// precificação (x402)

A Qotien agrega, referencia e data os dados fiscais e de aposentadoria franceses em 47 regimes. É um recurso que se explora, não um bem comum — quem busca valor paga. Toda capacidade de cálculo ou de referencial é paga em x402 desde a primeira chamada, tanto na REST quanto no MCP. Sem franquia anônima. O gratuito se limita ao que é necessário para o protocolo funcionar: capacites e versions.

Nível	Preço (USDC, Base)	Capacidades
protocolo	gratuito	saber o que o servidor faz e em qual data
tabela	0,05 $	fatos com fonte/data e tabelas aplicadas (referencial, TMI, PS, CEHR…)
estudo	0,25 $	cálculos compostos (IFI, CDHR, mais-valia, estimativa de aposentadoria, pensão…)
otimizador	1,00 $	otimização de fim de carreira classificada por ROI

Pague via cabeçalho X-PAYMENT (x402 v2). Uma chamada não paga recebe um HTTP 402 nos dois transportes; no MCP, o corpo carrega tanto os campos x402 (accepts) quanto um erro JSON-RPC -32002 — um cliente MCP incapaz de pagar vê um erro de transporte. O preço por capacidade está no bloco tarification do manifesto. Avalie antes de comprar: chave de teste nominal (cabeçalho X-Qotien-Trial, emissão manual — escreva para nós).

Uso aplicacional? Uma licença comercial em euros existe para volume regular — contact@qotien.fr. É o canal recomendado; o pedágio x402 é adequado para chamadas pontuais.

// exemplo (REST)

curl -s https://app.qotien.fr/api/fiscal/v1/calculate \ -H 'content-type: application/json' \ -d '{"capability":"impot_revenu","input":{"revenu_net_imposable":60000,"parts":2}}'

// três domínios: fiscal, aposentadoria, referencial

Fiscalidade (determinística, fiable): imposto de renda, TMI, CEHR/CDHR, contribuições sociais, mais-valias imobiliárias…

Aposentadoria (confiança variável): pensão bruta→líquida, pensão por regime (30+ caixas em pontos), pensão total consolidada (o RIS em uma chamada), estimativa enquadrada — e a otimização de fim de carreira: compra de trimestres (tabela CNAV 2026), sobretaxa parental, aposentadoria progressiva, menu de otimização classificado por ROI.

Referencial (sourcée): referentiel_valeur (uma constante por sua chave pública estável + fonte + referência legal + data + confiabilidade), referentiel_recherche (listar/filtrar as chaves) e referentiel_versions (ano fiscal + frescor). Para verificar ou citar um fato sem executar um cálculo.

Mapa de capacidades (qotien_capacites): chamável ANTES de escolher uma ferramenta, anuncia o que o motor sabe fazer e com qual confiabilidade por domínio (plan_hints também presente no manifesto) — para que um agente planeje e saiba quando fazer hedge.

→ Ver o manifesto completo (esquemas, fontes, plan_hints)

// para agentes de IA (MCP)

O servidor está publicado no registro oficial MCP sob io.github.herve-coulon/tax-retirement, e listado no Smithery / Glama / mcp.so. Um agente compatível com MCP pode descobri-lo e chamá-lo diretamente.

Por que isso importa: quando uma IA precisa calcular um imposto ou uma pensão, ela precisa de um motor com fonte, data e consciência de confiança — não de uma alucinação. É exatamente isso que a Qotien expõe.

// no navegador (WebMCP)

Cada página de qotien.fr declara essas ferramentas via navigator.modelContext (WebMCP). Um navegador com um agente de IA as descobre e chama diretamente na página — sem configurar um servidor MCP remoto, sem chave.

Progressivo: sem efeito onde a API não existe. As ferramentas usam o mesmo motor com fonte do MCP e da API REST — a confiança e as fontes viajam com o número.

// para humanos (e crawlers)

A mesma verdade, projetada em uma página legível: o índice dos textos de referência — cada constante fiscal e de aposentadoria 2026 com sua fonte primária, referência legal, data de verificação e nível de confiabilidade. Gerado a partir do mesmo referencial da API (fonte única).

Explorar o manifesto →

Descoberta gratuita · cálculo pago x402 (ou licença €) · dados 2026 com fonte · hospedado na UE

Qotien — referencial dos dados patrimoniais franceses, legível por humanos e máquinas. Estimativas indicativas, não aconselhamento financeiro.

Início · Simulador de aposentadoria · Simulador de imposto · Direitos de sucessão · Índice de fontes