# Archonum

> Residential proxy network with per-country exit IPs, a hosted MCP server that gives AI agents a real-device stealth browser (walks past bot walls like Cloudflare, Akamai, Kasada), and a JavaScript SDK for real-device CDP automation.

Key facts:
- REST API auth: `Authorization: Token <api-key>`; base URL `https://stage.archonum.com/api/v1/`
- Gateway: HTTP and SOCKS5 at `stagegw.archonum.com` (username + API token; suffixes like `-country_us`, `-session_abc`, `-ttl_15` select exit country and sticky sessions)
- MCP endpoint: `https://stage.archonum.com/mcp` (streamable HTTP; OAuth 2.1 sign-in or HTTP Basic with username:api-key)
- Billing: bandwidth-metered credits (MB); check with `GET /api/v1/credits/` or the MCP `get_credits` tool

## Docs

- [API documentation](https://stage.archonum.com/docs/): REST API, direct gateway usage, MCP for AI agents, JavaScript SDK
- [Agent skill](https://stage.archonum.com/skill.md): machine-readable MCP setup and tool guide for AI agents
- [OpenAPI schema](https://stage.archonum.com/api/schema/): machine-readable API specification

## SDK

- [archonum-sdk-js](https://github.com/Archonum/archonum-sdk-js): `@archonum/sdk` (client), `@archonum/engine` (automation), `@archonum/cli` (terminal) — all on npm

## Optional

- [Swagger UI](https://stage.archonum.com/api/schema/swagger-ui/): interactive API explorer
- [Start free trial](https://stage.archonum.com/register/): 1 GB / 7 days, business email required