Errors and troubleshooting

JSON-RPC layer

code	When
-32700	Parse error (invalid JSON body)
-32600	Invalid request
-32601	Method not found (e.g. unknown JSON-RPC method — you must use tools/list / tools/call on this server)
-32602	Invalid params — e.g. unknown tool name in params.name
-32000 to -32099	Server errors (rare)

tools/call never returns JSON-RPC error for “business” failures inside a tool: those come back as a normal result with isError: true and a content text payload describing quota, PREMIUM_REQUIRED, validation, or upstream service failure.

Common tool-level messages

• PREMIUM_REQUIRED (or the upgrade URL text) when calling generate_mock_exam or any FIFA Agent AI tool without a premium account / fam_live_ key.
• Quota strings from ask_study_assistant or search_scout when monthly limits are hit — call get_account_status / get_scout_usage and show the reset date to the end user.
• Admin failures on refresh_scout_player if the token is not an admin profile.

Quick checks

1. GET https://fifa.qtech.hr/api/health — is ok: true?
2. POST …/mcp with {"jsonrpc":"2.0","id":1,"method":"tools/list"} — do you get tools?
3. If premium tools fail, re-check Authorization: Bearer … and Account tier / key validity.

Next — Ops: health, mint, smoke tests →