Toolhood/Apps/Access keys
Access keys
for agents that run alone.
Claude, ChatGPT, Cursor and the other chat clients connect with the plain URL: no key, no sign-in. A key is for scripts and headless agents. It gives them their own limit instead of sharing the free one of your IP address.
01Who needs one
Most people never do. The limits below come straight from the engine.
You do not need a key if…you chat with Toolhood from Claude, ChatGPT, Cursor, VS Code, Zed or Windsurf. Paste the URL and go.
Get a key if…a script, a bot or an agent calls Toolhood on a schedule or from a server, and you want its calls counted on their own.
02Sign in
Keys belong to a wallet. You prove it is yours by signing a short text message: free, not a transaction, nothing moves.
03Your keys
Each key is shown once, then only its first characters. Toolhood stores a hash, never the key itself. Revoke one any time.
04Use it
Send it as a Bearer token. Same endpoint, same tools, your own limit.
05Good to know
- Keep it secret. Put it in an environment variable, never in public code or a screenshot. Anyone with the key spends your limit.
- A key cannot move funds. Toolhood only reads and prepares; every transaction is still signed in a wallet, on the signing page.
- Lost or leaked? Revoke it here and create a new one. The old one stops working at once.
- Holder tier: once $TOOLHOOD exists, a key whose wallet holds enough of it gets the holder limits, read on-chain. Until then it shows "after launch".