# Troubleshooting

Last updated: October 16, 2026

Source: https://flovia.dev/docs/troubleshooting

You can solve most problems by asking your agent. When you need Flovia, [contact Flovia](https://flovia.dev/contact) or ask your agent to send feedback.

## Flovia's tools do not appear

- Restart your agent after adding Flovia, or reconnect the flovia MCP server.
- Check that the key is set where the setup reads it. For Codex, that is the FLOVIA_KEY environment variable.
- If Flovia rejects the key, check it in [Console](https://console.flovia.dev/groupbuy/) and set it again.
- If Flovia does not respond, wait and try again, or send feedback.

## A limit is reached

- When a free window reaches 100%, free lookups pause until it resets. Ask your agent when it resets.
- Buying more credits is paused for now. Wait for the window to reset, or ask your agent to send Flovia feedback.
- If a data source is busy or rate limited, try again later. When the reply gives a wait time, wait that long first.
- [Free and paid use](https://flovia.dev/docs/usage) explains the limits.

## The result is unknown, or your agent stopped

- If a reply was lost or Flovia cannot tell whether a call ran, send the same request again with the same operation ID. It is never charged twice. Never start a new operation to recover an answer.
- If your agent stops midway, say “Continue from today's Flovia lookups”. Finished lookups are reopened rather than fetched again.

## An answer looks wrong

Ask your agent to send your feedback to Flovia in your own words. A lookup deducts at most its usual cost, and less if the answer is wrong. Your agent can also tell you what happened to feedback you sent.

## Your key is lost or leaked

[Contact Flovia](https://flovia.dev/contact). Flovia revokes the old key and issues a new one. Never paste a key into a conversation or a public repository.

## Refunds and payments

- Unused bought credits are refunded on request. Ask your agent to “Send Flovia feedback asking for a refund”. If you stopped sharing, ask within 30 days, because feedback is deleted after 30 days.
- If a payment could not be confirmed, your agent resends the same payment instead of making a new one. If it still cannot be confirmed, Flovia checks the blockchain within 3 business days (Japan business days) and either adds the credits or tells you why not.

## Find out what changed

Flovia is in alpha. To see what changed, ask your agent “What changed in Flovia recently?” (recent_updates in flovia_status).

## More

- [Flovia Group Buy docs](https://flovia.dev/docs)
- [Quickstart](https://flovia.dev/docs/quickstart)
- [Free use and bought credits](https://flovia.dev/docs/usage)
- [Data use](https://flovia.dev/docs/data-use)
- [Flovia Group Buy FAQ](https://flovia.dev/docs/faq)
- [Flovia Group Buy](https://flovia.dev/)
- [Terms of Service](https://flovia.dev/terms)
- [Privacy Policy](https://flovia.dev/privacy)