MCP server for Atheris proxies — live stock, ready proxy URLs, and usage, as tools for any MCP-capable agent.
Three tools with complete input schemas and descriptions. Naming follows verb_noun pattern (atheris_stock, atheris_proxy_url, atheris_usage). Descriptions are adequate (100-200 chars) and explain prerequisites (ATHERIS_PROXY_KEY requirement). However, atheris_stock and atheris_usage have empty input schemas with no parameters documented, limiting composability. atheris_proxy_url has well-structured parameters with enums and descriptions, but lacks output schema documentation. No error recovery guidance or actionable error messages. Missing tool annotations (readOnlyHint, idempotentHint). No pagination or result limits documented despite potential for large stock responses.
Get a ready-to-use Atheris proxy URL for a country. Returns an http:// or socks5:// URL you can hand to any HTTP client. Requires ATHERIS_PROXY_KEY. NOTE: the returned proxy_url and password embed your pak_ key — treat the result as a secret; do not log it or echo it into transcripts.
List live Atheris proxy stock by country and pool (mbl = mobile 4G/5G, peer = residential). No key required. Call this before atheris_proxy_url to pick a country that has capacity.
Check the access key's remaining GB and expiry. Requires ATHERIS_PROXY_KEY.
atheris_stock and atheris_usage have empty input schemas (no parameters). While correct for no-arg tools, they lack output schema documentation. LLMs cannot plan downstream calls without knowing what fields are returned (e.g., does stock include country codes, capacity numbers, pool types?).
No output schemas documented for any tool. LLMs need to know the structure of responses to extract relevant fields and chain tools. E.g., atheris_proxy_url should document that it returns {proxy_url, password, ...} so agents know what to pass to HTTP clients.
Error handling returns raw JSON from upstream API without recovery guidance. E.g., 'error: request failed: timed out after 20000ms' or API error responses do not tell the LLM what to do next (retry? ask user? try different country?). Missing error classification and actionable guidance.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
No tool annotations (readOnlyHint, idempotentHint). All three tools are read-only and idempotent, but LLMs cannot infer this. Annotations would clarify that these are safe to retry and do not modify state.
atheris_proxy_url description warns 'do not log it or echo it into transcripts' but the tool itself returns the secret proxy_url in plaintext. No mechanism to mark response fields as sensitive or to strip them from logs. Agents will log the full response including embedded credentials.