diff --git a/README.md b/README.md
index e37c475..2fcfe24 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,7 @@
AgentKey is the master key for the agent ecosystem. When using Claude, Manus, or other agents, you often need external data: social media, e-commerce, on-chain data, various APIs. That means hunting down API keys, managing subscriptions, or hitting dead ends.
-With AgentKey installed, your agent gains all these data capabilities automatically. No subscriptions, no extra registrations. Top up and go.
+With AgentKey installed, your agent gains all these data capabilities automatically. No per-provider registrations, no juggling separate API bills. One subscription and go.
> ⭐ Star this repo to get notified whenever we add new platform support or release updates.
@@ -59,7 +59,7 @@ Now: one AgentKey handles everything. **AgentKey unifies all the external access
Before touching the terminal, you can get a feel for AgentKey directly in your browser — the website and console explain things more visually than this README can.
- 🌐 **[agentkey.app](https://agentkey.app)** — Product overview, supported platforms, live demos, pricing details
-- 🎛️ **[console.agentkey.app](https://console.agentkey.app)** — Sign up, top up credits, manage your API key, track usage
+- 🎛️ **[console.agentkey.app](https://console.agentkey.app)** — Sign up, manage your subscription, manage your API key, track usage
The one-line install below is what plugs AgentKey into your AI agent. If you only want to look around first, the two links above are the friendlier starting point.
@@ -126,9 +126,9 @@ Native web access in Claude and ChatGPT has limited platform coverage. It often
-What if I run out of credits?
+How does pricing work? What if I use up my plan's credits?
-Just top up. No auto-renewal, no hidden charges.
+AgentKey is subscription-based. Each plan includes a monthly credit allowance; usage beyond that is billed pay-as-you-go as overage. You can upgrade your plan or manage billing anytime at [console.agentkey.app](https://console.agentkey.app). See [agentkey.app](https://agentkey.app) for current plans and pricing.
diff --git a/docs/README_zh.md b/docs/README_zh.md
index cf5c8a8..8ecad06 100644
--- a/docs/README_zh.md
+++ b/docs/README_zh.md
@@ -26,7 +26,7 @@
AgentKey 是 Agent 生态里的"万能钥匙"。用户在用 Claude、Manus 这些 Agent 时，经常需要获取外部数据（社交媒体、电商、链上数据、各种 API），但要么要自己找 API 填 Key，要么根本找不到解决方案。
-装了 AgentKey，Agent 就自动具备了这些数据获取能力。无需订阅，无需注册任何服务，充值即用。
+装了 AgentKey，Agent 就自动具备了这些数据获取能力。无需逐个注册服务、逐个管理账单，一份订阅全部搞定。
> ⭐ 右上角 Star 本项目，我们会持续更新平台接入变化，有新版本自动通知你。
@@ -59,7 +59,7 @@ Agent 就像半智能体，完全无法自主行动，不断需要人类帮助
在动命令行之前，你可以先在浏览器里熟悉一下 AgentKey —— 官网和后台讲得比 README 更直观。
- 🌐 **[agentkey.app](https://agentkey.app)** —— 产品介绍、支持的平台、在线演示、计费说明
-- 🎛️ **[console.agentkey.app](https://console.agentkey.app)** —— 注册账号、充值、管理 API Key、查看用量
+- 🎛️ **[console.agentkey.app](https://console.agentkey.app)** —— 注册账号、管理订阅、管理 API Key、查看用量
下面的一条命令是把 AgentKey 接进你的 AI Agent。如果只是想先看看，上面两个链接是更友好的入口。
@@ -126,9 +126,9 @@ Claude 与 ChatGPT 的原生联网与平台覆盖有限，往往触达不到推
-额度用完了怎么办？
+怎么计费？套餐额度用完了怎么办？
-充值即可；无自动续费，无隐藏扣款。
+AgentKey 采用订阅制。每档套餐包含每月的 credits 额度，超出部分按量计费（超额付费）。你可以随时在 [console.agentkey.app](https://console.agentkey.app) 升级套餐或管理账单。具体套餐与价格见 [agentkey.app](https://agentkey.app)。
diff --git a/skills/agentkey/SKILL.md b/skills/agentkey/SKILL.md
index 6ac6007..ae919c2 100644
--- a/skills/agentkey/SKILL.md
+++ b/skills/agentkey/SKILL.md
@@ -87,7 +87,7 @@ Try first, guide if needed. Never ask about API keys before executing.
| Error | Action |
|-------|--------|
| `Authentication failed` | "API key invalid. Get a new one at https://console.agentkey.app/" |
-| `Insufficient credits` | "Credits exhausted. Top up at https://console.agentkey.app/" |
+| `Insufficient credits` | "Your plan's credits are exhausted. Upgrade your subscription or manage billing at https://console.agentkey.app/" |
| `Rate limited` | "Rate limited. Wait a moment and try again." |
| `not_found` | Report to user. Do NOT retry with guessed IDs. |
| Missing required param | Fix params using the `suggestion` field and retry once. |
diff --git a/skills/agentkey/references/cost-aware.md b/skills/agentkey/references/cost-aware.md
index 48ef164..18ae5c5 100644
--- a/skills/agentkey/references/cost-aware.md
+++ b/skills/agentkey/references/cost-aware.md
@@ -2,7 +2,7 @@
Load this when the user's request implies **≥3 AgentKey calls** or **≥10 estimated credits**. The SKILL.md "Rules" section points here; you do not need to re-derive when it applies.
-The goal: never burn the user's credit balance silently. Every batch run goes balance-check → cost-estimate → user-confirm → execute.
+The goal: never burn the user's credit balance silently. AgentKey is subscription-based: each plan includes a credit allowance for the billing cycle, and usage beyond it is billed as pay-as-you-go overage — so silent overspend costs the user real money. Every batch run goes balance-check → cost-estimate → user-confirm → execute.
## 1. Pre-batch workflow
@@ -53,7 +53,7 @@ After estimating, present the plan in a single message before executing:
Wait for an explicit yes before calling `execute_tool`. If the user is operating an automated environment (no human in the loop indicated in conversation), proceed if the estimate is **≤ 25% of their remaining balance**; otherwise still pause and surface the numbers.
-If the estimate **exceeds** the balance, do not start the batch. Tell the user how many calls fit (`floor(balance / credits_per_call)`) and ask whether to (a) run that subset, (b) stop, or (c) top up at https://console.agentkey.app first.
+If the estimate **exceeds** the remaining allowance, do not start the batch — the excess would bill as overage. Tell the user how many calls fit within the allowance (`floor(balance / credits_per_call)`) and ask whether to (a) run that subset, (b) stop, (c) proceed anyway and accept the overage charge, or (d) upgrade their plan at https://console.agentkey.app first.
## 4. Cost-saving moves before you ask
@@ -78,6 +78,6 @@ Read the new balance via `agentkey_account` again only if the user asks — call
If `agentkey_account` errors or returns 0 with no clear reason, do not silently proceed. Tell the user:
-> I couldn't verify your AgentKey balance before this batch. Top up or check status at https://console.agentkey.app, then re-ask.
+> I couldn't verify your AgentKey balance before this batch. Check your subscription status at https://console.agentkey.app, then re-ask.
A failed balance read is almost always (a) the API key is missing/expired, or (b) a transient network blip. Both deserve user awareness before spending.