Open the beta console, sign in with an issued key, preview a request, then wait for approval and proof.
https://xoggai-agent.com/beta/
// agent-readable docs
Connect agents to x402 routing.
Start with dry-run intent routing, inspect matched endpoints, then use the public beta console for operator-approved Base Sepolia execution. Mainnet stays intentionally disabled.
Quickstart
Pick the path that matches what you are building. Public routing is dry-run-first; testnet execution is gated through the beta console and operator approval.
Call the backend from an agent or script and keep discovery in dry-run mode.
GET /intent?q=what%20is%20the%20ETH%20price&budget=0.005&dry=true
Review beta requests from trusted tooling, approve only valid requests, then execute on Base Sepolia.
REQUESTED -> APPROVED -> EXECUTED
Load the public agent files so Claude, Codex, Cursor, or another tool knows the exact safety boundary.
https://xoggai-agent.com/connect-agent/
Beta console guide
The beta console is the user-facing product flow. It creates controlled requests; it does not expose wallet keys and it does not send payment from browser code.
The issued beta key becomes a short-lived session. Users only see their own quota, requests, and execution history.
XoggAI dry-runs the intent, checks endpoint price and budget, then queues the request for review.
Trusted operators approve, reject, cancel, or execute requests. Expired and over-budget requests cannot continue.
Executed requests show status, payment proof fields, and Base Sepolia transaction links when available.
Agent snippet
Paste this into an agent, script, or backend job to route natural-language intent through XoggAI in dry-run mode.
xoggai-agent-starter.ts
const XOGGAI_API = 'https://xoggai-backend.onrender.com';
export async function routeIntent(intent, budget = 0.005) {
const url = new URL(`${XOGGAI_API}/intent`);
url.searchParams.set('q', intent);
url.searchParams.set('budget', String(budget));
url.searchParams.set('dry', 'true');
const res = await fetch(url);
if (!res.ok) {
throw new Error(`XoggAI route failed: ${res.status}`);
}
return res.json();
}
const route = await routeIntent('what is the ETH price?');
console.log(route.endpoint);Execution model
XoggAI separates endpoint discovery from payment execution so agents can evaluate routing before spending.
Default public behavior. Returns route metadata and endpoint candidates without sending wallet payment.
Safe for public demos
Shows endpoint fit, price, latency, and schema
Uses
dry=true
Approved beta requests can execute through the audited Base Sepolia path after an operator decision.
Requires authenticated beta access
Requires explicit operator approval
Mainnet remains disabled
Developer integration kit
Use these files when wiring XoggAI into an agent, backend job, or developer tool. The public examples stay dry-run-first and keep secrets outside browser code.
/examples/xoggai-sdk.js
JavaScript helper
Copyable helper for routeIntent, searchEndpoints, and execution status checks.
/examples/curl.md
curl flow
Health check, dry-run routing, endpoint search, beta login, and admin queue examples.
/examples/claude.md
Claude instructions
Prompt rules for routing user intent through XoggAI before any execution decision.
/examples/codex.md
Codex instructions
Implementation guardrails for code agents that add x402 intent routing.
/examples/cursor.md
Cursor instructions
Project context and implementation rules for editor-integrated agents.
/openapi.json
OpenAPI schema
Machine-readable contract for public routing, beta request creation, and operator endpoints.
API surface
The public API is small on purpose: route intents, search endpoints, inspect stats, and fetch agent-readable metadata.
GET /intent
Route intent
Returns the best endpoint preview for a natural-language request.
GET /search
Search endpoints
Returns ranked endpoint candidates for a query.
GET /api/info
Service info
Returns public backend mode, docs links, network, and live-execution status.
GET /api/stats
Network stats
Returns public counters shown across the website and terminal.
GET /api/endpoints
Endpoint index
Returns available x402 endpoint metadata.
GET /api/feed
Activity feed
Returns public routing and endpoint activity entries.
GET /health
Health check
Returns service status for uptime checks and deploy smoke tests.
FAQ
Short answers for the parts that matter most before someone integrates or tests XoggAI.
No. XoggAI is live as a production-grade public testnet beta. Execution runs on Base Sepolia and mainnet is intentionally disabled.
No. Browser code can create beta requests after login, but wallet signing and x402 execution stay server-side and operator-gated.
Dry-run returns the matched endpoint, price, latency, rating, schema, and metadata without executing the upstream paid call.
$XOGG is the public token context for XoggAI. Execution remains testnet-first and mainnet migration is separate.
Agent files
Raw files stay public for agents and crawlers. This viewer keeps them easier to inspect in-browser.
skill.md
Agent Skill
Instructions for agents that want to route natural-language intent through XoggAI.
Loading document...