Tool Limits
Cardzen limits how quickly a connected assistant can make requests and how much it can do in a day or month. All assistants connected to the same Cardzen account share the daily and monthly allowances. Pro accounts have higher allowances.
Some requests, such as running a report, use more of your allowance than a simple lookup. Changes to your wallet or credits also count toward a monthly write allowance. If you reach that allowance, you can still look up information within your remaining limits.
Daily allowances reset at midnight Eastern time. Monthly allowances reset at midnight Eastern time on the first day of each month. If your assistant gives a wait time or reset date, wait until then before trying again. Check your wallet first if you're unsure whether a change was saved.
A large wallet, history window, or result can return result_too_large. Narrow the request or ask for a smaller page where the tool supports it.
Wallet Size and History
The same 20-active-card limit applies to adding and reopening cards in Cardzen and through a connector. Frozen cards count as active. Larger existing wallets can still be browsed and managed. For a long list, the assistant can request the next page. Past cards remain separate from the active limit. A report that exceeds its calculation limit returns a capacity error, and the underlying saved history remains in Cardzen.
Closing a card moves it to Past cards and preserves eligible history. Removing a mistaken wallet entry keeps saved credit usage. Permanently erasing the entry deletes its saved Cardzen history. These actions leave your issuer account alone.
If your connector has wallet-history write permission, you can ask it to correct a specific ownership period or explicitly erase a saved entry. Your assistant may ask you to confirm in chat before it makes the change. If an earlier request's outcome is unclear, check the card's timeline or My Cards before requesting the change again.
On Free, you can ask which credits expire this month and see their names, cards, and dates. Tracked usage, remaining amounts, and credit streaks require Pro.
Connection Does Not Start
- Confirm the server address is exactly
https://mcp-stage.cardzen.ai/mcp. - Confirm the client supports remote Streamable HTTP MCP and browser-based OAuth.
- Check whether custom apps or connectors are available for your assistant plan and workspace.
- Restart setup from the assistant so it creates a fresh authorization request.
Authorization Page Expired
Authorization requests are short-lived. Return to the assistant and start setup again. Do not reuse an old authorization-page URL or send it to another person.
If you created a Cardzen account or completed setup before the request expired, those changes remain saved. Go back to the original assistant tab or app where you started, then try connecting Cardzen again. An unavailable request may also have already been used in another tab, so check the assistant's connection status before retrying. A network failure after selecting Approve can leave the result uncertain; do not approve the same request again automatically.
No Cards in Your Wallet
You can connect an empty Cardzen wallet and use Help or the public card catalog. For a personal card-choice or wallet answer, add your cards in Cardzen first. Cardzen does not invent card holdings from the assistant conversation, and the assistant should request permission before any supported card write.
Connected App Is Unavailable in Cardzen
If Cardzen cannot load Connected Apps, it shows an unavailable message instead of pretending that no apps are connected. Retry later. An unavailable list does not revoke existing grants.
Disconnect or Reconnect
Open Account & Settings -> Connections & MCP, select the connected app, and choose Disconnect. To reconnect, return to the assistant and complete setup and authorization again.
A Tool Is Unavailable
The assistant may have cached an older tool list. Start a new conversation or reconnect if needed. The Cardzen server still enforces the current grant, plan capability, scope, and tool switch even if a client displays an outdated tool.
- Insufficient scope (
insufficient_scope): reconnect and approve the access required by that tool. Cardzen does not silently expand an existing grant. - Paid capability unavailable (
upgrade_required): the requested tool is not included in the account's current Cardzen capability. The error names the minimum capability without exposing billing-provider details. - Tool disabled (
tool_disabled): Cardzen has temporarily or permanently disabled that exact tool. Repeated retries will not override the switch. - Rate limited (
rate_limited): wait for the stated retry time or reset date before trying again. Check your wallet if you are unsure whether a change was saved.
When contacting Cardzen support, share the tool name, error code, and approximate time of the request. Do not send an OAuth code, access token, Firebase credential, browser-session value, or full assistant conversation.
For data-handling details, see MCP Privacy and Security.