--- name: aient.ai description: aient.ai provides account provisioning, session onboarding, and diagnostics for the AIent platform, which integrates AI agent telemetry with x402 payment flows. It exposes three paid API endpoints covering organisation creation, user session onboarding with GitHub App consent, and retrieval of x402 problem diagnostics. host: aient.ai --- # aient.ai aient.ai is a platform host focused on bootstrapping and monitoring AI agent infrastructure tied to x402 payments. It serves agents and operators who need to programmatically provision AIent organisations, onboard new users through a GitHub App authorization flow, and inspect x402-related errors or anomalies. It is distinct in combining credential provisioning, consent-based onboarding, and payment-flow diagnostics in a single host. ## When to use this host Use aient.ai when an agent needs to programmatically create a new AIent organisation, onboard a new operator through GitHub App consent, or retrieve x402 payment-flow diagnostics. Do not use it to look up or refresh credentials for an existing account — create-aient-account always creates a net-new organisation. Do not use it for real-time streaming of problem events or for submitting new problem records; fetch-x402-problems is read-only and paginated. For subsequent API calls after onboarding, use the session token returned by onboard-aient-session rather than calling these provisioning endpoints again. This host has no skills for telemetry ingestion, payment execution, or GitHub App management directly — those are handled by downstream systems using the credentials this host issues. ## Capabilities ### Account and Session Provisioning Creates the foundational credentials and session tokens needed to use AIent services. Organisation creation yields wallet addresses and telemetry endpoints; session onboarding yields a session token and GitHub App consent URL. - **`create-aient-account`** — Creates a new AIent account and returns an organisation ID, wallet address, OTEL ingest endpoint, and environment key in a single paid call. - **`onboard-aient-session`** — Creates an AIent session via a paid x402 POST request, returning a session token and a human-approval URL for GitHub App installation consent. ### x402 Diagnostics Retrieves paginated problem records and diagnostic data for x402 payment flows, enabling agents to inspect active issues or anomalies. - **`fetch-x402-problems`** — Fetches a paginated list of x402-related problems and diagnostics from the aient.ai platform. ## Workflows ### New Operator Bootstrap *Use when an agent needs to fully provision a new AIent operator from scratch, obtaining both organisation credentials and a user session with GitHub App consent in sequence.* 1. **`create-aient-account`** — Provision a new AIent organisation and obtain the organisationId, walletAddress, ingestEndpoint, and environmentKey. 2. **`onboard-aient-session`** — Create an onboarding session to obtain a session token and the GitHub App install-consent URL the operator must visit to authorize the integration. ### Provision and Diagnose *Use when an agent needs to set up a new AIent account and immediately check for any existing x402 problems that might affect the new organisation.* 1. **`create-aient-account`** — Create the new organisation and retrieve its credentials. 2. **`fetch-x402-problems`** — Fetch current x402 problem records to identify any active issues in the payment flow that could impact the newly provisioned organisation. ## Skill reference ### `create-aient-account` **AIent Signup** — Creates a new AIent account and returns an organisation ID, wallet address, OTEL ingest endpoint, and environment key in a single paid call. *Use when:* Use when an agent needs to provision a new AIent organisation and obtain the credentials (organisationId, walletAddress, ingestEndpoint, environmentKey) required to start sending telemetry or using AIent services. *Not for:* Do not use to retrieve credentials for an existing account or to rotate/refresh keys; this creates a net-new organisation on every call. **Returns:** Returns success=true and a data object containing organisationId, walletAddress, ingestEndpoint (OTEL URL), environmentId, and environmentKey for the new account. **Example:** `{"_note": "POST https://aient.ai/x402/signup with x402 payment header; body is empty JSON object"}` --- ### `fetch-x402-problems` **x402 Problems** — Fetches a paginated list of x402-related problems and diagnostics from the aient.ai platform. *Use when:* Use when an agent needs to retrieve current x402 problem records or diagnostics, such as checking for active issues, errors, or anomalies in the x402 payment flow. *Not for:* Do not use for submitting or creating new problems; this endpoint is read-only. Not suitable for real-time streaming of problem events. **Returns:** Returns success=true with a data object containing an empty problems array and pagination metadata (offset=0, limit=25, total=0). **Example:** `GET https://aient.ai/x402/problems` --- ### `onboard-aient-session` **AIent Onboard** — Creates an AIent session via a paid x402 POST request, returning a session token and a human-approval URL for GitHub App installation consent. *Use when:* Use when an agent needs to onboard a new user or operator into AIent, obtaining a session token and the install-consent URL that the operator must visit to authorize the GitHub App. *Not for:* Do not use for subsequent API calls after onboarding is complete; the session token returned should be used for those. Not suitable for re-authenticating an existing active session. **Returns:** Returns success=true with a session_id, a session_token, a human-approval install-consent URL in next_actions, required GitHub permissions, and session expiry details. **Example:** `POST https://aient.ai/x402/onboard Content-Type: application/json {}` ---