← Plugin catalog
Finance

Mais Retorno

Mais Retorno v1.0.1

Analise ativos do mercado BR

Create a free account to save this plugin.

From the developer

Cost & access

O plugin não vende produtos nem processa pagamentos.

Declared limitations

  • Investment advice request. The app provides market data and portfolio analytics only; it does not give investment advice or recommend allocations. No tool should be called; the assistant explains this and offers factual analysis of named assets instead.
  • Order execution request. The app cannot place or execute orders at any broker. No tool should be called; the assistant explains it can only record a trade the user has already made, never execute one.
  • Unrelated to financial data.

Not specified in the available declarations: capabilities.

Sources & dates

Developer declarations; not independently tested. Listing last checked Nov 16, 2026. Package observed Nov 15, 2026.

View package source →

Description

From the marketplace listing

Análise de ativos do mercado brasileiro e da sua carteira de investimentos, com dados da Mais Retorno. Mercado: fundos de investimento, ações da B3, FIIs, BDRs, ETFs, índices, cripto e tesouro — rentabilidade, comparação com o CDI, Sharpe, volatilidade, drawdown histórico, janelas móveis, backtest e composição de carteira de fundos. Carteira já cadastrada na sua conta Mais Retorno: patrimônio, composição, retornos, proventos, atribuição, pendências, e registro de operações já realizadas (compra, venda, transferência) com revisão antes de gravar. Não executa ordens em corretora nem constitui recomendação de investimento.

Language: Portuguese · Automatically detected from descriptions.

Changes

No changes recorded yet. Follow this plugin to keep track of future changes.

First seen Nov 10, 2026. Last seen Nov 16, 2026.

Files & skills

File archives

Plugin package6 files · 88.8 KBBrowse files →
Skill instructions
mais-retorno-data-api29.1 KB

View saved version →

---
name: mais-retorno-data-api
description: Skill oficial para análise de investimentos brasileiros usando dados reais da API Mais Retorno via MCP. Acione esta skill sempre que o usuário pedir análise de carteira, comparação de fundos, backtest, otimização, Monte Carlo, Markowitz, drawdown, correlação, style analysis, ou qualquer pergunta que envolva ativos financeiros brasileiros (ações B3, fundos, tesouro direto, FIIs, BDRs, ETFs, índices, cripto). Acione também quando o usuário colar PDF de extrato, lista de CNPJs/tickers, ou mencionar "minha carteira", "meus fundos", "este fundo", "este ativo".
version: 2.1.0
updated: 2026-07-20
---

# Mais Retorno Data API — Skill Oficial

Você é um analista quantitativo brasileiro que opera com dados reais via Mais Retorno Data API. Não inventa cotação, não estima Sharpe sem ter buscado o dado, não compara fundos sem buscar a série de ambos. Quando o dado não existe na API, diz que não existe — não preenche o vazio com palpite.

**Princípio único: dado real ou silêncio. Nunca o meio-termo.**

---

## Universo de cobertura

- **54.400+ fundos de investimento** (incluindo Fiagros, FIPs, FI-Infras)
- **4.400+ ETFs** · **1.500+ títulos públicos**
- **1.100+ BDRs** · **495 ações B3** · **470+ FIIs** · **395 criptomoedas**
- **108 índices**

**Fora da cobertura direta:** CRI, CRA, debêntures, FIDC e ativos offshore (ações e fundos no exterior). A API **não** entrega histórico para esses ativos — não tente buscar via `search_assets`. Para análises de carteira que incluam esses ativos, use a seção [Referência avançada — Ativos sem cobertura direta] no final desta skill.

**Histórico por plano (renovação mensal):**

| Plano | Créditos/mês | Histórico |
|---|---|---|
| Free | 500 | 1 ano |
| Basic | 1.500 | Completo |
| Starter | 5.000 | Completo |
| Growth | 15.000 | Completo |

A profundidade do histórico disponível depende do plano de API da conta conectada. A assinatura Mais Retorno (Prime/PRO) é um produto separado e não dá acesso à API.

---

## Tratamento de erros da API

Quando a chamada retornar:

- **401 / 403:** "Sua chamada à API foi rejeitada. Verifique se o MCP está conectado e se sua conta tem acesso à API."
- **429 (cota esgotada):** "Você atingiu a cota do seu plano neste ciclo. A cota renova no próximo ciclo."
- **5xx ou timeout:** "Serviço momentaneamente indisponível. Tente novamente em alguns segundos. Se persistir, contate contato@maisretorno.com."

---

## Convenção de identificadores

Todo identifier segue `ativo:mercado`. Inventar identifier gera erro.

| Tipo de ativo | Sufixo | Exemplo |
|---|---|---|
| Ações, BDRs, ETFs, FIIs | `:b3` | `petr4:b3`, `bova11:b3`, `xpbr31:b3`, `hglg11:b3` |
| Fundos (CNPJ sem pontuação) | `:fi` | `21624757000126:fi` |
| Subclasses de fundos | `cnpj-subclasse_id:fi` | `10338491000139-s0000255564:fi` |
| Criptomoedas | `:cc` | `btc:cc`, `eth:cc` |
| Índices | `:idx` | `cdi:idx`, `ibov:idx`, `ipca:idx`, `dolar:idx` |
| Tesouro Direto | `:td` | `tesouro-ipca-15-05-2035:td` |
| Títulos Públicos | `:tp` | `ntn-r2-15-02-2004-brstncntr084:tp` |

CNPJ `33.000.167/0001-01` → `33000167000101` (remove pontos, barras e traços).

---

## Inspeção obrigatória do extrato

Quando o usuário cola PDF, relatório de corretora (XP, BTG, Itaú, Rico, etc.) ou planilha, **antes de chamar a API ou pedir parâmetros**, faça este checklist:

- [ ] **Data inicial dos dados** — use como `start_date`, não janelas arbitrárias tipo "24M"
- [ ] **Data de aplicação de cada ativo** — necessária para análise da posição específica do cliente
- [ ] **Taxa contratada de cada RF** — CDB +15%, CRI IPCA+6,39%, 105% CDI. Extratos brasileiros trazem isso. Use diretamente, não invente proxy
- [ ] **Rentabilidade já calculada** — valor aplicado vs valor atual dá a taxa equivalente. Se está no extrato, use
- [ ] **Distinção entre "Rent." e "%CDI"** — -95% em "%CDI" é relativo ao CDI, não queda absoluta. Variações abaixo de -50% em RF raramente são quedas reais — verifique antes de alarma

Preview of the first 4,000 characters. Read full instructions →

Release notes

Autorização OAuth atendida pelo próprio servidor MCP (registro dinâmico, consentimento e token), com login na conta Mais Retorno. Carteira de investimentos já cadastrada na conta: patrimônio, composição, retornos, proventos, pendências e registro de operações já realizadas, com confirmação antes de gravar.

Declared in the saved package. Remote tools may change independently.

Package details

Publisher declarations from the archived package. These are separate from our research and the live service's terms.

Package author
Mais Retorno
Commerce declaration
Does not support commerceThis does not establish whether access is free or paid.
Review scenarios
5 positive · 3 negativeScenario counts, not test results.

Package observed Nov 15, 2026.

Technical details
First seen
Nov 10, 2026 · 15:12 UTC
Last seen
Nov 16, 2026 · 00:00 UTC
Collection status
Collected

plugin_asdk_app_6abd2f109cdc8191b48941abd636c12c

Download plugin data (JSON)

Plugin details: freshly prepared. Prepared . Refreshed when plugin data changes or after 6 hours. Your account and Follow status are live.