Dashboard & Quota System
User Dashboard
After registering on JellyHub and logging in, users can access their personal dashboard at /hub/dashboard.
Login required — the dashboard redirects unauthenticated visitors to the login page.
Features
- API Key Management — create, view, and revoke JellyHub API Keys.
- Usage Overview — see call counts for today, last 7 days, and this month.
- Quota Cards — per-MCP quota status with progress bars and reset dates.
- Promo Code Redemption — enter promo codes to receive bonus credits.
- Per-MCP Detail — click any MCP card to view detailed usage logs and quota breakdown.
API Key Lifecycle
- User clicks "Create Key" on the dashboard.
- The full key (
jh_live_...) is shown once. The user must save it immediately. - Dashboard only stores the key prefix for display (e.g.,
jh_live_a3f8...). - Users configure the key in their SEAJelly Dashboard MCP settings.
- Keys can be revoked at any time.
Quota System
Quota Types
| Type | Description |
|---|---|
| Free Monthly | Auto-granted on first use, resets on the 1st of each month |
| Bonus | Granted via promo codes, has optional expiry |
| Paid | Reserved for future Stripe integration |
Deduction Priority
When a request passes through the Gateway, quota is deducted in this order:
- Bonus credits (if available)
- Free monthly quota
- Paid credits (future)
If all quotas are exhausted, the Gateway returns a JSON-RPC error (-32001).
Real-time Quota Info
Every Gateway response includes a custom header:
X-JellyHub-Quota-Remaining: 4832
This allows client applications to display remaining quota without additional API calls.
Admin Dashboard
Administrators access the backend at /admin/dashboard.
Admin Capabilities
| Page | Purpose |
|---|---|
| Tags | Create and manage hierarchical category tags |
| Skills | Create skills, tag them, link required MCPs |
| MCPs | Add MCPs with upstream config, pricing, and free quota settings |
| Promo Codes | Generate codes with configurable credit amounts and expiry |
| Usage | Global usage analytics, filterable by MCP and time range |
| Quotas | Search users, view their quota status, manually adjust balances |
Important Notes for Admins
- Connectivity Test: Always test a new MCP upstream endpoint before enabling it. The test calls
tools/listto verify JSON-RPC compatibility. - Rate Limits: Each MCP has a configurable
rate_limit_qpm(queries per minute). Set this based on the upstream provider capacity. - Free Quota Strategy: Setting
free_monthly_quotato a non-zero value (e.g., 5000) means every registered user gets that many free calls per month — this is the primary user acquisition lever. - Upstream Security: Never expose
upstream_urlorupstream_headersto the frontend. These are server-side only.