Check your connection
Check the connection
Section titled “Check the connection”Paste this into a new chat in your connected agent:
Call Flovia's flovia_status once and summarize the result. If it includes stopped or free_pending, tell me what they say. Don't call any other Flovia tools. If Flovia's tools aren't available, run only your app's MCP list command (for example claude mcp list or codex mcp list; in Cursor, look at MCP settings) and tell me which of these it shows, with its fix: flovia not listed → add it again with the setup in Flovia Console; missing environment variable such as FLOVIA_KEY → set it in your shell profile (such as ~/.zshrc) and start the app from a new terminal; 401 or unauthorized → create a new key in Flovia Console. Never show, read out, or paste the key or any header value, and don't edit settings.A status check does not fetch provider data. If the tools are missing, use By client.
If Flovia refuses the connection
Section titled “If Flovia refuses the connection”When Flovia refuses a key or a sign-in, it answers with an HTTP status and an error code, and nothing is sent to a data source.
| Status | Error | What it means and what to do |
|---|---|---|
| 401 | formal_registration_required |
Test access has ended. API keys issued during the test no longer work. Complete formal registration from your invitation email, then open https://console.flovia.dev/auth/ to connect your app again. |
| 401 | unauthorized |
Flovia did not accept the key, or none was sent. Without a key, the message is “Send your Flovia key as Authorization: Bearer <key>. Get a key at https://console.flovia.dev/ (opens in new tab).” With a key Flovia does not know, it is “This Flovia key is invalid or revoked.”: create a new key in Console (opens in new tab) and put it in your agent’s config. If you connected with OAuth, the body is only {"error":"unauthorized"}: connect again from Quick Install in Console. |
| 403 | formal_registration_required |
You connected with OAuth, and test access for that account has ended. The body is {"error":"formal_registration_required"}. Complete formal registration from your invitation email, then connect your app again from https://console.flovia.dev/auth/. |
Test-period history and stored answers do not carry over to your new account.
Try one small lookup
Section titled “Try one small lookup”If the status allows use, ask for the current ETH price in USD from CoinGecko once, and include the observation time. This uses a little of your free allowance. If the status says your key is stopped or your free allowance is pending, stop and follow the explanation it returns.
More first requests are on First requests. To make the same kind of lookup from code and read its reply, see First lookup and its reply.