Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.universalbench.dev/llms.txt

Use this file to discover all available pages before exploring further.

UniversalBench bakes authentication into the URL path. Every customer has a personal URL containing their API key in the path: 
https://universalbench-mcp.penantiaglobal.workers.dev/u/ubk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
The ubk_ prefix identifies a UniversalBench key. The 64 character hex string after is the secret.

​
Why URL embedded auth

Most MCP services use a shared endpoint plus an X-API-Key header configured separately in your client. Every MCP client handles custom headers differently. Some break silently when headers are present. Some force them through OAuth flows that do not apply here. Embedding the key in the URL path solves all of that. One paste, works everywhere. The client never needs to know about headers.

​
Treat your URL like a password

Anyone with your URL can make calls billed to your account. To minimize blast radius:
  • Do not commit your URL to public repositories
  • Do not paste it into screenshots or shared logs
  • Rotate the URL immediately if you suspect exposure

​
Rotating your URL

If your URL is compromised or you want a fresh one for any reason, click “Rotate key” in your dashboard. The old URL is invalidated immediately. Any MCP client configured with the old URL will start returning auth errors and needs to be updated with the new URL.

​
Alternative authentication methods

If for some reason you cannot use the URL embedded auth (rare), the API also accepts the key in a few other places:
MethodExample
Authorization headerAuthorization: Bearer ubk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Custom headerX-Api-Key: ubk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Query parameter?key=ubk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
All four methods work against the base URL https://universalbench-mcp.penantiaglobal.workers.dev/. The URL embedded form is preferred because it requires zero client configuration.

​
Billing status endpoint

To check your current quota and wallet balance: 
curl -H "Authorization: Bearer ubk_your_key" \
  https://universalbench-mcp.penantiaglobal.workers.dev/billing/status
Response: 
{
  "tier": "free",
  "free_remaining_this_month": 993,
  "free_monthly_limit": 1000,
  "wallet_balance_usd": "0.00",
  "paid_calls_available": 0,
  "paid_call_cost_usd": "0.008",
  "min_topup_usd": "5.00",
  "max_topup_usd": "500.00"
}
To get a fresh dashboard session without a password, request a magic link to the email on file: 
curl -X POST https://universalbench-mcp.penantiaglobal.workers.dev/magic-link \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'
A sign in link valid for 15 minutes is sent to your email. Clicking it logs you into the dashboard.