# raiken.io account help centre --- > Guides, steps, tips and common questions for raiken.io account, in full. Landing page: https://raiken.io/kb/account --- # When raiken.io AI tools refuse a call > What it means when your agent hears that free calls are used, premium is needed, the key is paused or the tools are busy. ## Goal Understand why a raiken.io tool refused your agent's call and what to do next. ## Before you start - An AI agent connected to raiken.io tools with your key. ## Steps 1. **Read the refusal** Your agent passes on raiken.io's answer. Each refusal names what happened and, where it applies, when the next call works. 2. **Check your plan** Open AI tools on your member page. What your plan includes shows what each tool allows. Today one tool is offered: Help centre search, included for every member, up to 600 calls an hour. As product tools are added, it also shows your free calls left, when they reset and which product's premium unlocks full use. ## Tips - Ask your agent to tell you raiken.io's exact words. They name the wait and the fix. ## Result You know whether to wait, slow your agent down or unlock full use with premium. ## If something goes wrong - **Not found** -> If the tools are not switched on yet, calls answer Not found. Keys you make now start working when they are. - **Free calls used** -> For product tools as they are added: you used the free calls for those tools in this window. The answer says when the next free call works and which product's premium gives full use. - **Tools need premium** -> For product tools as they are added: these tools have no free calls. The answer names the product whose premium unlocks them, with a link. - **Limit reached: calls an hour** -> Full use has an hourly limit too. Wait until the time the answer gives. - **Too fast** -> Your agent called many times in one minute. Wait for the time the answer gives and let it call less often. - **Paused after too many calls** -> Your key or account kept calling too fast or asked for tools that are not offered, so it is paused for a while. Check what your agent repeats, then try again after the time the answer gives. - **The tools are busy** -> Many members are calling at once. Try again after the seconds the answer gives. - **Too many requests from this address** -> The answer reads: Too many requests from this address. Try again in the time it gives. Many calls came from your network in a short time. Wait, then let your agent call less often. - **The tools are paused for maintenance** -> raiken.io is working on the tools. Your keys and calls are kept. Try again later. - **This tool is not offered** -> Your agent asked for a tool that the public raiken.io tools don't include. Let it list the tools again and pick one of those. - **A raiken.io tools key is needed** -> The key is missing, mistyped or revoked. Check the Authorization header, or revoke the key and make a new one on AI tools. - **Only a tools key works here** -> The answer reads: Only a tools key (scope mcp:public alone) works here. The key was made somewhere else. Make a key on AI tools and use that one. - **This account is not active** -> The answer reads: This raiken.io account is not active, so its tools key does not work. Contact raiken.io support to reactivate it. - **We could not check your purchases** -> The answer reads: We could not check your purchases just now. Try again in a minute. Something on raiken.io's side failed for a moment, so wait a minute and call again. - **We could not count this call** -> The answer reads: We could not count this call just now. Try again in a minute. Something on raiken.io's side failed for a moment, so wait a minute and call again. ## Common questions ### Does a refused call use up my free calls? A call refused for being too fast or busy is not counted. Free calls count the calls that ran. ## Related guides - [Use raiken.io tools from your AI agent](https://raiken.io/kb/account/account-ai-tools): Make a key on your member page and connect Claude Code, VS Code, Cursor or any other MCP app to raiken.io tools. --- Source: https://raiken.io/kb/account/account-ai-tools-refusals (raiken.io account help centre). Reviewed: 2026-11-20. --- # Use raiken.io tools from your AI agent > Make a key on your member page and connect Claude Code, VS Code, Cursor or any other MCP app to raiken.io tools. ## Goal Let the AI agent you already use call raiken.io tools with a key of its own, and switch it off again whenever you like. ## Before you start - A raiken.io member account with a verified email address. - An AI app that connects to MCP servers over HTTP and lets you add a request header, such as Claude Code, VS Code or Cursor. ## Steps 1. **Open AI tools** Sign in and open AI tools on your member page (raiken.io/member/ai-tools). What your plan includes lists the tools your agent can use and how much. Today one tool is offered: Help centre search, included for every member, up to 600 calls an hour. 2. **Make a key** Under Make a key, type a Key name that says where you use it, for example Cursor at work, and click Make key. One key per app is easiest to revoke later. 3. **Copy the key now** Your new key is shown only this once. Click Copy key. If you lose it, revoke it under Your keys and make another. 4. **Connect Claude Code** Under Connect your agent, open Claude Code and copy the command, then run it in a terminal: claude mcp add --transport http raiken https://raiken.io/mcp/public --header "Authorization: Bearer YOUR_KEY" 5. **Or connect VS Code** Open VS Code under Connect your agent and copy the block into .vscode/mcp.json in your project. It adds a server named raiken with type http, the url https://raiken.io/mcp/public and a header Authorization: Bearer YOUR_KEY. 6. **Or connect Cursor** Open Cursor under Connect your agent and copy the block into ~/.cursor/mcp.json. It adds raiken under mcpServers with the url https://raiken.io/mcp/public and the same Authorization header. 7. **Or connect any other app** Any other app needs two things from Any other app: the server address https://raiken.io/mcp/public and the header Authorization: Bearer YOUR_KEY. Add them where the app sets up an HTTP MCP server, then restart it if it asks. 8. **Ask your agent** Ask your agent for something a raiken.io tool does. Under Your keys, the key shows when it was last used. ## Tips - Make one key per app. Then revoking one app never stops the others. - Keep keys out of files you share or commit. Anyone with your key can use your calls. ## Result Your agent calls raiken.io tools with its own key, within what your plan includes. ## If something goes wrong - **Make key is greyed out.** -> Your account has the most keys it can have. Revoke one you no longer use under Your keys, then make a new one. - **The page asks you to verify your email address.** -> Click Open your profile and verify your email address, then come back to AI tools. - **The app says a raiken.io tools key is needed.** -> The key is missing, mistyped or revoked. Check that the header reads Authorization: Bearer followed by a space and the key. If you can't find the key, revoke it and make a new one. - **Claude.ai or ChatGPT only offers to sign in.** -> Claude.ai and ChatGPT connect only by signing in (OAuth). raiken.io does not offer that yet, so a pasted key does not work there. Use Claude Code, VS Code or Cursor. ## Common questions ### Who can use the AI tools? raiken.io members. Today one tool is offered: Help centre search, included for every member, up to 600 calls an hour. As product tools are added, each member gets a few free calls for them, and the premium of the product named next to them unlocks full use, up to an hourly limit. ### How do I stop an app from using my account? Under Your keys, click Revoke next to its key and confirm. Apps using that key stop working at once. ### What happens to what my agent sends? What you send is used for the answer and not kept. raiken.io logs which tool each key called, without what you sent, and keeps that log for 30 days to count calls and stop misuse. ### My agent got a refusal. What does it mean? Each refusal says what happened and when to try again. The guide on refusals explains each one. ## Related guides - [When raiken.io AI tools refuse a call](https://raiken.io/kb/account/account-ai-tools-refusals): What it means when your agent hears that free calls are used, premium is needed, the key is paused or the tools are busy. --- Source: https://raiken.io/kb/account/account-ai-tools (raiken.io account help centre). Reviewed: 2026-11-20.