# AX Check: maisretorno.com Checked 2026-10-09. Docs are solid, but pricing isn't posted anywhere public. The API and MCP connector are clearly documented with auth details, but no pricing page was fetched — all plan prices came from gated sources, not a public page. ## Onboarding needs a login ## Coding sessions All three independent sessions (DeepSeek V4.1 Flash, Kimi K3, Qwen 3.8 Max) completed and each produced a pricing table covering Free/Basic/Starter/Growth tiers with credit costs, but each flagged that the actual plan prices were behind a login wall and had to be treated as assumptions rather than confirmed figures. ### DeepSeek V4.1 Flash [View public run](https://agents.withgauge.com/p/runs/58980631-53c0-4f83-8841-322aa21e5fc1) · [Read transcript](https://www.ax-check.com/maisretorno.com/sessions/deepseek.json) README.maisretorno.md gives a full plan/credit table (Free 500, Basic 1500, etc.) plus per-operation credit costs, and explicitly flags the assumption that Basic/Starter/Growth prices are login-gated and not publicly known. #### End-to-end onboarding - **Onboarding needs a login**: Agent located the real hosted Mais Retorno Market Data API and confirmed it requires an X-Api-Key tied to an account/subscription. It never obtained a key (that requires human signup/login on the dashboard) and so never completed an authenticated call. Both free-tier search and quotes calls returned 401 Unauthorized with no key or a dummy key, which is the correct documented behavior, not a bug. The session ends with the agent stating it needs a human-supplied key to proceed. Event 34: ```text === free /search no key === HTTP 401 === /quotes no key === HTTP 401 ``` Event 92: ```text === dummy key (real network call) === Request failed: HTTP 401 (/search/petrobras): Unauthorized Check that MR_API_KEY is valid and active. ``` Event 94: ```text Both `/search` and `/quotes` return `401` without an account**, and generating a key requires signing up/logging in at the Mais Retorno dashboard — something I can't do. ``` #### Hallucinated URLs None identified in this transcript. #### Blockers - **API key requires dashboard signup/login the agent cannot complete**: All endpoints, including the nominally 'free' search, require a valid X-Api-Key tied to an active subscription. Generating that key requires creating an account at maisretorno.com/app/meu-perfil/api, which is a human action outside the agent's reach in this session. This is a normal authentication requirement, not a product defect, and it stopped the agent from making any successful 200 call. Event 34: ```text HTTP 401 ``` Event 59: ```text 200 https://maisretorno.com/app/meu-perfil/api ``` Event 94: ```text generating a key requires signing up/logging in at the Mais Retorno dashboard — something I can't do ``` - **Paid plan prices hidden behind login**: The marketing pricing page (maisretorno.com/planos) only shows the consumer app tiers (Free/Prime/RetornoPro); the API-specific plan prices for Basic, Starter, and Growth are not listed there and only appear after logging into the dashboard, limiting how fully the agent could answer the pricing question. Event 67: ```text Free Para conhecer a plataforma na prática R$ 0,00 Grátis para sempre ``` Event 75: ```text Login | Mais Retorno ``` #### Suggested Changes - **Publish API-tier pricing (Basic/Starter/Growth) on the public docs or pricing page**: The developer docs list credits per plan but the actual subscription prices for Basic/Starter/Growth are only visible after login at maisretorno.com/app/meu-perfil/api. Add these prices to the public developers.maisretorno.com page or maisretorno.com/planos so prospective developers can evaluate cost before signing up. Verify by checking that an unauthenticated fetch of the pricing page returns dollar/real amounts for all API tiers, not just Free. Event 67: ```text Free Para conhecer a plataforma na prática R$ 0,00 Grátis para sempre ``` Event 75: ```text Login | Mais Retorno ``` - **Offer a true no-signup sandbox call for the free search endpoint**: The docs market /search as free ('grátis — teste agora sem gastar nenhum crédito') but it still returns 401 without an API key, so a developer cannot try a single call before registering. Consider allowing a limited, keyless trial hit on /search (e.g., rate-limited by IP) on data.maisretorno.com, and confirm by curling the search endpoint with no X-Api-Key header and checking for a 200 instead of 401. Event 34: ```text === free /search no key === HTTP 401 ``` Event 41: ```text Buscar ativos é grátis — teste agora sem gastar nenhum crédito (gere sua api-key em maisretorno.com/app/meu-perfil/api ) ``` ### Kimi K3 [View public run](https://agents.withgauge.com/p/runs/73f37c75-1976-43e6-a412-a73fcbbe40cc) · [Read transcript](https://www.ax-check.com/maisretorno.com/sessions/kimi.json) README.md pricing table lists Free/Basic/Starter/Growth tiers with explicit assumptions (annual billing ~17% off monthly, credit costs per call, 7-day refund policy) sourced from maisretorno.com/api. #### End-to-end onboarding - **Onboarding needs a login**: Agent could not self-serve an API key. Every Mais Retorno endpoint requires an X-Api-Key tied to an account created via a human web signup at maisretorno.com/app/meu-perfil/api. Agent confirmed this requirement, tested endpoints and got 401s without a key (and even with a fake key), then explicitly stopped and asked the human to supply a real key rather than attempting to obtain one itself. No authenticated call was ever made. Event 42: ```text --- quotes sem key: HTTP 401 --- search sem key: HTTP 401 --- com key fake: HTTP 401 ``` Event 63: ```text I can't run the example live. Every endpoint returns `401` without a key, and keys are only issued from an account at `maisretorno.com/app/meu-perfil/api`. ``` Event 63: ```text account registration (email/Google sign-in, terms acceptance) is a step only you can do — I won't create accounts on your behalf. ``` #### Hallucinated URLs None identified in this transcript. #### Blockers - **API key requires human account signup**: Mais Retorno's Market Data API rejects all requests without a valid X-Api-Key (confirmed via 401 on real and fake keys). Keys can only be generated from the authenticated web portal at maisretorno.com/app/meu-perfil/api, which requires a human to register an account. This is standard product behavior (not a bug) but it is an unresolved blocker for autonomous agent onboarding — the agent could not obtain or use real credentials and stopped as instructed by the task. Event 42: ```text --- com key fake: HTTP 401 ``` Event 63: ```text account registration (email/Google sign-in, terms acceptance) is a step only you can do — I won't create accounts on your behalf. ``` #### Suggested Changes - **Offer a self-serve or sandbox API key for the Free plan**: On the developers.maisretorno.com quickstart, the Free tier is described as requiring no credit card, but the key is still gated behind full account registration (email/Google sign-in). Consider exposing a quick, no-registration trial key (e.g., time-limited demo key) for the free 'search' endpoint so first-time developers and automated agents can validate the integration before creating an account. Verify by confirming a request to https://data.maisretorno.com/mr-data/v4/api/search/{query} succeeds with the trial key without prior signup. Event 34: ```text Acesse maisretorno.com/app/meu-perfil/api e gere sua api_key. ``` Event 63: ```text The Free tier needs no credit card, but account registration (email/Google sign-in, terms acceptance) is a step only you can do ``` ### Qwen 3.8 Max [View public run](https://agents.withgauge.com/p/runs/0bfa2be8-5c75-43d1-a580-1a8cff9b45b4) · [Read transcript](https://www.ax-check.com/maisretorno.com/sessions/qwen.json) Final output gives a pricing table (Free/Basic/Starter/Growth/Enterprise credits, per-operation credit costs) with stated assumptions: monthly reset, no rollover, free tier ≈500 quote lookups/month, 429 on exhaustion. #### End-to-end onboarding - **Onboarding needs a login**: The agent researched Mais Retorno's docs thoroughly and built a working example script, but never obtained a real API key. Account/key creation requires a human to sign up at the web portal (maisretorno.com/app/meu-perfil/api), which the agent explicitly could not do itself. It only tested against a fake key (mr_test_invalid), confirming the script correctly handles a 401 — not a successful authenticated operation. Event 87: ```text The API requires a key tied to an account. **Creating the free account and generating the key** (shown only once, at `maisretorno.com/app/meu-perfil/api`) is a human web-portal signup step I can't complete. ``` Event 76: ```text HTTP 401 on /search/petr4: API key missing or invalid (X-Api-Key header). ``` Event 75: ```text MAIS_RETORNO_API_KEY=mr_test_invalid python3 maisretorno_example.py 2>&1 | head -5 ``` #### Hallucinated URLs None identified in this transcript. #### Blockers - **No self-service way to obtain an API key**: Mais Retorno requires signing up on its web portal and generating a key through the dashboard UI; there is no API or CLI path to create an account or key programmatically. This is a product design choice (human account creation gate), not an agent error, and it stopped the agent from running any authenticated call against the live API. Event 60: ```text Preços e assinatura em maisretorno.com/app/meu-perfil/api . ``` Event 87: ```text a human web-portal signup step I can't complete ``` #### Suggested Changes - **Offer a programmatic or sandbox key-issuance path for automated/agent users**: Currently the only way to get an X-Api-Key is through the maisretorno.com/app/meu-perfil/api web dashboard (per developers.maisretorno.com 'Autenticação' section). Consider a signup/token endpoint (e.g., a CLI command or REST call with email verification) so headless or agent-driven workflows can self-provision a free-tier key without a human clicking through the portal. Validate by having a fresh script obtain a working key and successfully call GET /search/{query} end-to-end without manual portal steps. Event 60: ```text Preços e assinatura em maisretorno.com/app/meu-perfil/api . ``` ### Task given to each agent Help me build a simple example using Mais Retorno. Tell me how pricing works, and briefly tell me whether this product will be easy for you to manage. Let me know if you get blocked. If this product has no developer workflow you can act on, say so plainly and stop. Stay light: use the hosted product through its SDK or API. Do not start local service stacks or wait for long-running commands; if the quickstart requires either, say so plainly and stop. No product credentials were supplied and no purchases were authorized. ## Score: B · 81/100 (provisional) Grades come from completed site checks. Coding sessions and skipped checks do not affect the score. ### Clarity - **Failed** — Homepage answers Markdown requests ```text Homepage returned text/html for a text/markdown request; no Markdown representation offered. ``` - **Pass** — llms.txt provides an actionable documentation index ```text llms.txt links API page, developer docs, and MCP page with descriptions and plans. ``` - **Pass** — llms.txt provides navigation guidance ```text llms.txt organizes sections (data use, licensing, API, MCP) with descriptive links for navigation. ``` - **Pass** — llms.txt mentions offered API, MCP, and skills ```text llms.txt describes the REST API, MCP connector, and its OAuth endpoint and clients. ``` - **Pass** — A compact guide representation exists ```text llms.txt is a compact Markdown guide covering data use, API, MCP and licensing. ``` - **Pass** — A focused guide is directly retrievable ```text llms.txt fetched directly at /llms.txt with 200 and text/markdown content. ``` - **Pass** — Equivalent instructions fit a token budget ```text llms.txt is 1146 tokens, well under the 8000-token budget. ``` - **Skipped** — Product-docs links survive format changes ```text Homepage Markdown unsupported, so link preservation across formats cannot be judged. ``` - **Pass** — The compact guide is independently actionable ```text llms.txt gives API/MCP overview, auth via X-Api-Key, credit plans and connector URL; actionable. ``` - **Pass** — Install and next-step links resolve ```text Homepage API/MCP links resolve: /api, /mcp, and login-gated app pages return 200. ``` ### Onboarding - **Skipped** — Docs lead to a relevant quickstart ```text llms.txt links to API docs and MCP page, but no quickstart page was fetched. ``` - **Skipped** — Installation commands are extractable ```text No installation or CLI guide page was fetched; only llms.txt index available. ``` - **Skipped** — Code examples are available without interaction ```text llms.txt mentions API examples exist but no code example page was fetched. ``` - **Pass** — Prerequisites and auth boundaries are explicit ```text llms.txt states authentication via X-Api-Key header and free plan signup. ``` ### Pricing - **Skipped** — Pricing is readable without interaction ```text No pricing page fetched; homepage only links to Retorno PRO/Prime landing pages without prices. ``` - **Skipped** — Prices are stated, not gated ```text No pricing page fetched; homepage shows no stated prices for any plan. ``` - **Skipped** — Pricing units and limits are explicit ```text No pricing page fetched; no plan units or limits visible in supplied evidence. ``` - **Pass** — Agents identify pricing and its assumptions ```text 3 of 3 sessions were judged on pricing; 0 fell short. DeepSeek V4.1 Flash: README.maisretorno.md gives a full plan/credit table (Free 500, Basic 1500, etc.) plus per-operation credit costs, and explicitly flags the assumption that Basic/Starter/Growth prices are login-gated and not publicly known. Kimi K3: README.md pricing table lists Free/Basic/Starter/Growth tiers with explicit assumptions (annual billing ~17% off monthly, credit costs per call, 7-day refund policy) sourced from maisretorno.com/api. Qwen 3.8 Max: Final output gives a pricing table (Free/Basic/Starter/Growth/Enterprise credits, per-operation credit costs) with stated assumptions: monthly reset, no rollover, free tier ≈500 quote lookups/month, 429 on exhaustion. This behavioural item does not affect the fast grade. ``` ### Activation - **Pass** — An API reference or OpenAPI spec is reachable ```text API page and llms.txt link to developers.maisretorno.com docs; REST endpoints, X-Api-Key auth, examples shown. ``` - **Pass** — An MCP server is documented and well-formed ```text MCP page documents connector URL, OAuth login, Claude/ChatGPT setup, API-key clients, and credit usage. ``` - **Skipped** — A CLI install path is documented ```text No CLI install path documented; only REST API and MCP connector offered. ``` - **Skipped** — SDK packages resolve on their registries ```text No SDK or packaged CLI registry lookup supplied; only REST API and MCP documented. ``` - **Skipped** — Agent skills are published ```text No agent skills published or referenced in fetched pages. ``` [Full report data](https://www.ax-check.com/maisretorno.com/report.json)