Troubleshooting

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 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 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. 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).