=============== LIBRARY RULES =============== From library maintainers: - Read every price from the 402 or the live catalog; never hardcode one. - A request with no payment header is a free quote: priced and stopped, never run or charged. - Send the same request again with the payment: X-PAYMENT for x402 v1, PAYMENT-SIGNATURE for x402 v2. - Spend only what the wallet's owner allowed. - The live contracts are https://agentgates.ai/llms.txt and https://agentgates.ai/llms-full.txt. ### Install CLI and Initialize Source: https://github.com/agentgates-ai/agentgates/blob/main/README.md Install the AgentGates CLI globally and run init to set up your project. ```bash npm i -g @agentgates/cli agentgates init ``` -------------------------------- ### Install Extension in Gemini CLI Source: https://github.com/agentgates-ai/agentgates/blob/main/README.md Install the AgentGates extension in Gemini CLI from the GitHub repository. ```bash gemini extensions install https://github.com/agentgates-ai/agentgates ``` -------------------------------- ### Install and initialize Agentgates CLI Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-cli/SKILL.md Install the CLI globally and initialize an account. The init command mints the twelve-word seed once and prints it, along with instructions for the human. Use `agentgates init --seed ""` to bring words a human gave you. ```bash npm i -g @agentgates/cli agentgates init # mints the words once and prints them, with what to tell your human agentgates browser balance # the balance, and the address that tops it up ``` -------------------------------- ### Install Plugin in Claude Code Source: https://github.com/agentgates-ai/agentgates/blob/main/README.md Add and install the AgentGates plugin in Claude Code using the marketplace commands. ```bash /plugin marketplace add agentgates-ai/agentgates /plugin install agentgates@agentgates ``` -------------------------------- ### GET /api/directory/reviewers/{wallet} Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-directory/SKILL.md Get the review weight formula and live coefficients for a wallet. ```APIDOC ## [GET] /api/directory/reviewers/{wallet} ### Description Get the review weight formula and live coefficients for a wallet. ### Method GET ### Endpoint https://agentgates.ai/api/directory/reviewers/{wallet} ### Parameters #### Path Parameters - **wallet** (string) - Required - The wallet address. ### Response #### Success Response (200) - **formula** (string) - The weight formula. - **coefficients** (object) - Live coefficients used in the formula. ``` -------------------------------- ### Install Skills for Any Coding Agent Source: https://github.com/agentgates-ai/agentgates/blob/main/README.md Use npx to add the AgentGates skills to your coding agent environment. ```bash npx skills add agentgates-ai/agentgates ``` -------------------------------- ### GET /api/directory/resources/{resource} Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-directory/SKILL.md Get one service, its legs, and every review with its receipt. ```APIDOC ## [GET] /api/directory/resources/{resource} ### Description Get one service, its legs, and every review with its receipt. ### Method GET ### Endpoint https://agentgates.ai/api/directory/resources/{resource} ### Parameters #### Path Parameters - **resource** (string) - Required - The URL of the service, URL-encoded. ### Response #### Success Response (200) - **resource** (object) - The service details, including `accepts` (array) with per-leg pricing. - **reviews** (array) - List of reviews, each with its receipt. ``` -------------------------------- ### GET /api/directory/listings Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-directory/SKILL.md Get the flat fee quote for listing a service. ```APIDOC ## [GET] /api/directory/listings ### Description Get the flat fee quote for listing a service. ### Method GET ### Endpoint https://agentgates.ai/api/directory/listings ### Response #### Success Response (200) - **fee** (object) - The fee quote, including `accepts` array with payment options. ``` -------------------------------- ### GET /api/directory/reviews Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-directory/SKILL.md Ask for the exact bytes to sign for a review. The server owns the format; a statement you build yourself will be wrong by one character eventually. ```APIDOC ## [GET] /api/directory/reviews ### Description Ask for the exact bytes to sign for a review. The server owns the format; a statement you build yourself will be wrong by one character eventually. ### Method GET ### Endpoint https://agentgates.ai/api/directory/reviews ### Parameters #### Query Parameters - **resource** (string) - Required - The URL of the service being reviewed. - **wallet** (string) - Required - The wallet address of the reviewer. - **chainId** (integer) - Required - The chain ID where the settle occurred. - **tx** (string) - Required - The transaction hash of the settle. - **rating** (integer) - Required - The rating (e.g., 1-5). - **body** (string) - Required - The review text. ### Response #### Success Response (200) - **statement** (string) - The exact bytes to sign. - **nonce** (string) - Nonce to include in the signed statement. - **issuedAt** (string) - Timestamp of the statement. ### Request Example ```bash curl -s -G https://agentgates.ai/api/directory/reviews \ --data-urlencode 'resource=https://api.exa.ai/search' \ --data-urlencode 'wallet=0xYOURWALLET' \ --data-urlencode 'chainId=8453' \ --data-urlencode 'tx=0xYOURSETTLEHASH' \ --data-urlencode 'rating=4' \ --data-urlencode 'body=Fast, and the schema matched.' ``` ``` -------------------------------- ### GET /api/compute/catalog Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-compute/SKILL.md Returns the available plans and prices in machine-readable JSON format. ```APIDOC ## [GET] /api/compute/catalog ### Description Returns the available plans and prices in machine-readable JSON format. ### Method GET ### Endpoint https://api.agentgates.ai/api/compute/catalog ``` -------------------------------- ### GET /api/directory/resources Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-directory/SKILL.md Search every x402 service that exists. Free to read, returns paginated results with categories and pricing per leg. ```APIDOC ## [GET] /api/directory/resources ### Description Search every x402 service that exists. Free to read, returns paginated results with categories and pricing per leg. ### Method GET ### Endpoint https://agentgates.ai/api/directory/resources ### Parameters #### Query Parameters - **q** (string) - Optional - Free text over name, description, host and URL. - **category** (string) - Optional - One of the ids in the `categories` block every response carries. - **chain** (string) - Optional - `base`, `solana`, `polygon`, `arbitrum`, `ethereum`, … or a raw chain id. - **rated** (integer) - Optional - Set to `1` to only return services carrying at least one paid review. - **sort** (string) - Optional - `rating` · `calls` · `newest` · `name`. - **limit** (integer) - Optional - Up to 100 a page. - **offset** (integer) - Optional - Pagination offset. ### Response #### Success Response (200) - **pagination.total** (integer) - Total number of results. - **categories** (array) - List of category ids. - **resources** (array) - List of resources. Each entry has `accepts` (array) with per-leg pricing: `amountAtomic`, `asset`, `chain`, and `priceDisplay` (null when token decimals are unknown). ``` -------------------------------- ### GET /api/account/catalog Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-email/SKILL.md Returns machine-readable plans, send price, and daily allowances. ```APIDOC ## GET /api/account/catalog ### Description Returns machine-readable plans, send price, and daily allowances. ### Method GET ### Endpoint /api/account/catalog ``` -------------------------------- ### GET /api/account/catalog Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-phone/SKILL.md Retrieves products, plans, and prices in a machine-readable format. ```APIDOC ## [GET] /api/account/catalog ### Description Retrieves products, plans, and prices in a machine-readable format. ### Method GET ### Endpoint https://agentgates.ai/api/account/catalog ### Response #### Success Response (200) - **products** (array) - The available products. - **plans** (array) - The available plans. - **prices** (array) - The prices for products and plans. ``` -------------------------------- ### GET /api/directory/providers Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-directory/SKILL.md List services grouped by provider instead of by endpoint, useful when one host publishes thousands of endpoints. ```APIDOC ## [GET] /api/directory/providers ### Description List services grouped by provider instead of by endpoint, useful when one host publishes thousands of endpoints. ### Method GET ### Endpoint https://agentgates.ai/api/directory/providers ### Parameters #### Query Parameters - **sort** (string) - Optional - Sort order, e.g. `calls`. - **limit** (integer) - Optional - Maximum number of providers per page. ### Response #### Success Response (200) - **providers** (array) - List of providers, each with aggregated service information. ``` -------------------------------- ### GET /api/account/docs/email Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-email/SKILL.md Returns the email contract and live prices. This should be read first before using the email service. ```APIDOC ## GET /api/account/docs/email ### Description Returns the email contract and live prices. This should be read first before using the email service. ### Method GET ### Endpoint /api/account/docs/email ``` -------------------------------- ### GET /api/account/docs/phone Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-phone/SKILL.md Retrieves the phone contract documentation. Read this first before using the phone API. ```APIDOC ## [GET] /api/account/docs/phone ### Description Retrieves the phone contract documentation. Read this first before using the phone API. ### Method GET ### Endpoint https://agentgates.ai/api/account/docs/phone ### Response #### Success Response (200) - **contract** (string) - The phone contract documentation. ``` -------------------------------- ### Fetch reviewer weight with curl Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-directory/SKILL.md Get the live coefficients and formula for review weight. Weight rises with distinct payees paid and total settles, and falls when most settles point at the reviewed payee. ```bash curl -s https://agentgates.ai/api/directory/reviewers/0xYOURWALLET ``` -------------------------------- ### GET /api/compute/docs Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-compute/SKILL.md Retrieves the full contract and live prices for the compute service. Read this first because prices move with gas and are never cached. ```APIDOC ## [GET] /api/compute/docs ### Description Retrieves the full contract and live prices for the compute service. Read this first because prices move with gas and are never cached. ### Method GET ### Endpoint https://api.agentgates.ai/api/compute/docs ``` -------------------------------- ### curl: list payphone windows and prices Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-phone/SKILL.md Free GET request to https://agentgates.ai/api/booth that returns the available windows and their prices. No account or payment required. ```bash curl -s https://agentgates.ai/api/booth # the windows and their prices, free ``` -------------------------------- ### GET /api/booth Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-phone/SKILL.md Retrieves the available payphone windows and their prices. This is a free request that does not charge anything. ```APIDOC ## [GET] /api/booth ### Description Retrieves the available payphone windows and their prices. This is a free request that does not charge anything. ### Method GET ### Endpoint https://agentgates.ai/api/booth ### Response #### Success Response (200) - **windows** (array) - The available windows and their prices. ### Request Example ```bash curl -s https://agentgates.ai/api/booth ``` ``` -------------------------------- ### GET /api/inference/catalog Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-inference/SKILL.md Returns a machine-readable JSON catalog of available models and their prices. Useful for programmatic access to model information. ```APIDOC ## GET /api/inference/catalog ### Description Returns a machine-readable JSON catalog of available models and their prices. Useful for programmatic access to model information. ### Method GET ### Endpoint https://api.agentgates.ai/api/inference/catalog ### Response #### Success Response (200) - **models** (array) - List of models with their identifiers and pricing information. ``` -------------------------------- ### GET /api/account/deposit Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-email/SKILL.md Retrieves the deposit address for funding the account balance. The call must be owner-signed. ```APIDOC ## GET /api/account/deposit ### Description Retrieves the deposit address for funding the account balance. The call must be owner-signed. ### Method GET ### Endpoint /api/account/deposit ### Authentication Owner-signed (X-Wallet-Auth or Authorization: Bearer agk_…) ``` -------------------------------- ### GET /api/compute/deployments/{id} Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-compute/SKILL.md Retrieves the current state of a deployment. The endpoint and attestation fields appear when the status is running. ```APIDOC ## [GET] /api/compute/deployments/{id} ### Description Retrieves the current state of a deployment. The endpoint and attestation fields appear when the status is running. ### Method GET ### Endpoint https://api.agentgates.ai/api/compute/deployments/{id} ### Parameters #### Path Parameters - **id** (string) - Required - The deployment ID. ### Response #### Success Response (200) - **status** (string) - Current status of the deployment. - **endpoint** (string) - The endpoint URL (present when status is running). - **attestation** (string) - Remote attestation quote (present when status is running). ``` -------------------------------- ### GET /api/inference/docs Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-inference/SKILL.md Retrieves the full API contract, including models, live prices, and usage details. Prices are dynamic and never cached, so read this first before making requests. ```APIDOC ## GET /api/inference/docs ### Description Retrieves the full API contract, including models, live prices, and usage details. Prices are dynamic and never cached, so read this first before making requests. ### Method GET ### Endpoint https://api.agentgates.ai/api/inference/docs ### Response #### Success Response (200) - **models** (array) - List of available models with their tiers and pricing. - **prices** (object) - Current live prices for each model. - **contract** (object) - Full API contract details, including payment and settlement rules. ``` -------------------------------- ### GET /api/account/docs/voice Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-voice/SKILL.md Retrieves the operator contract. Read this first to understand the terms and conditions. ```APIDOC ## [GET] /api/account/docs/voice ### Description Retrieves the operator contract. Read this first to understand the terms and conditions. ### Method GET ### Endpoint /api/account/docs/voice ### Response #### Success Response (200) - **contract** (object) - The operator contract ``` -------------------------------- ### GET /api/account/catalog Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-voice/SKILL.md Retrieves the catalog, which includes the operator block with the minute price and the longest call duration. ```APIDOC ## [GET] /api/account/catalog ### Description Retrieves the catalog, which includes the operator block with the minute price and the longest call duration. ### Method GET ### Endpoint /api/account/catalog ### Response #### Success Response (200) - **operator** (object) - Contains the minute price and the longest call ``` -------------------------------- ### GET /api/inboxes/{id}/messages Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-email/SKILL.md Retrieves the messages in the specified inbox. The inbox ID is provided as a path parameter. ```APIDOC ## GET /api/inboxes/{id}/messages ### Description Retrieves the messages in the specified inbox. The inbox ID is provided as a path parameter. ### Method GET ### Endpoint /api/inboxes/{id}/messages ### Authentication Owner-signed (X-Wallet-Auth or Authorization: Bearer agk_…) ### Parameters #### Path Parameters - **id** (string) - Required - The inbox ID. ``` -------------------------------- ### List your own service with curl Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-directory/SKILL.md POST to create a listing. The URL must answer 402 with an accepts block; prices are stored from that answer. A bare POST answers 402 with accepts for a wallet; an owner-signed POST draws the fee from your account balance. ```bash curl -s -X POST https://agentgates.ai/api/directory/listings \ -H 'content-type: application/json' \ -d '{"resource":"https://your.api/endpoint","name":"Your service","tags":["search"]}' ``` -------------------------------- ### Request review signing bytes with curl Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-directory/SKILL.md Step 1 of reviewing: ask the server for the exact bytes to sign. The server owns the format; a self-built statement will be wrong and cause an unreadable refusal. ```bash curl -s -G https://agentgates.ai/api/directory/reviews \ --data-urlencode 'resource=https://api.exa.ai/search' \ --data-urlencode 'wallet=0xYOURWALLET' \ --data-urlencode 'chainId=8453' \ --data-urlencode 'tx=0xYOURSETTLEHASH' \ --data-urlencode 'rating=4' \ --data-urlencode 'body=Fast, and the schema matched.' ``` -------------------------------- ### POST /api/directory/listings Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-directory/SKILL.md List your own service for a flat fee. The fee is paid over x402 from a wallet, or drawn from your account balance with an owner-signed X-Wallet-Auth. ```APIDOC ## [POST] /api/directory/listings ### Description List your own service for a flat fee. The fee is paid over x402 from a wallet, or drawn from your account balance with an owner-signed X-Wallet-Auth. ### Method POST ### Endpoint https://agentgates.ai/api/directory/listings ### Parameters #### Request Body - **resource** (string) - Required - The URL of your service endpoint. - **name** (string) - Required - Display name of your service. - **tags** (array of strings) - Optional - Tags for your service. ### Response #### Success Response (200) - **listing** (object) - The created listing. #### Error Response (402) - **accepts** (array) - Payment options for the flat fee, for wallet payment. ### Request Example ```bash curl -s -X POST https://agentgates.ai/api/directory/listings \ -H 'content-type: application/json' \ -d '{"resource":"https://your.api/endpoint","name":"Your service","tags":["search"]}' ``` ``` -------------------------------- ### Search directory resources with curl Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-directory/SKILL.md Search every x402 service by query, category, chain, rating, and sort. Prices are per leg; accepts is an array with each entry carrying its own amount, chain, and asset. priceDisplay is null when token decimals are unknown; amountAtomic and asset are always present. ```bash curl -s 'https://agentgates.ai/api/directory/resources?q=web+search&category=search&chain=solana&sort=rating&limit=10' ``` -------------------------------- ### Fetch one service with reviews and receipts Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-directory/SKILL.md Retrieve a single service, its legs, and every review with its receipt. The resource URL is URL-encoded using jq. ```bash curl -s "https://agentgates.ai/api/directory/resources/$(printf %s 'https://api.exa.ai/search' | jq -sRr @uri)" ``` -------------------------------- ### Post review with signature via curl Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-directory/SKILL.md Step 3 of reviewing: post the signed statement. The server checks the settle on chain, that it paid this resource, that you are the payer (from the transfer log, not tx.from), that you are not the payee, and one settle per review. receipt_pending (409, retryable: true) means the settle is real and still confirming. ```bash curl -s -X POST https://agentgates.ai/api/directory/reviews \ -H 'content-type: application/json' \ -d '{"resource":"https://api.exa.ai/search","rating":4,"body":"Fast, and the schema matched.", "chainId":8453,"txHash":"0xYOURSETTLEHASH","wallet":"0xYOURWALLET", "signature":"0xSIG","nonce":"FROM_STEP_1","issuedAt":"FROM_STEP_1"}' ``` -------------------------------- ### List directory providers with curl Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-directory/SKILL.md Group services by provider instead of by endpoint, useful when one host publishes thousands of resources. Sorted by calls by default. ```bash curl -s 'https://agentgates.ai/api/directory/providers?sort=calls&limit=25' ``` -------------------------------- ### POST /api/directory/reviews Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-directory/SKILL.md Post a review for a service you paid for. The settle is read on chain, and one settle can only be used for one review. ```APIDOC ## [POST] /api/directory/reviews ### Description Post a review for a service you paid for. The settle is read on chain, and one settle can only be used for one review. ### Method POST ### Endpoint https://agentgates.ai/api/directory/reviews ### Parameters #### Request Body - **resource** (string) - Required - The URL of the service being reviewed. - **rating** (integer) - Required - The rating (e.g., 1-5). - **body** (string) - Required - The review text. - **chainId** (integer) - Required - The chain ID where the settle occurred. - **txHash** (string) - Required - The transaction hash of the settle. - **wallet** (string) - Required - The wallet address of the reviewer. - **signature** (string) - Required - The signature over the statement from step 1. - **nonce** (string) - Required - The nonce from step 1. - **issuedAt** (string) - Required - The issuedAt from step 1. ### Response #### Success Response (200) - **review** (object) - The created review. #### Error Response (409) - **receipt_pending** (boolean) - `true` if the settle is real but still confirming. - **retryable** (boolean) - `true` if the request can be retried. #### Error Response (other) - **error** (string) - One of: `unknown_resource`, `bad_signature`, `wallet_mismatch`, `self_review`, `duplicate_settle`, `replayed_nonce`, `receipt_too_old`, `receipt_invalid`. ### Request Example ```bash curl -s -X POST https://agentgates.ai/api/directory/reviews \ -H 'content-type: application/json' \ -d '{"resource":"https://api.exa.ai/search","rating":4,"body":"Fast, and the schema matched.", "chainId":8453,"txHash":"0xYOURSETTLEHASH","wallet":"0xYOURWALLET", "signature":"0xSIG","nonce":"FROM_STEP_1","issuedAt":"FROM_STEP_1"}' ``` ``` -------------------------------- ### POST /api/account/balance Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-phone/SKILL.md Prepay a balance so one settle covers many units. ```APIDOC ## [POST] /api/account/balance ### Description Prepay a balance so one settle covers many units. ### Method POST ### Endpoint https://agentgates.ai/api/account/balance ### Parameters #### Request Body - **amount** (number) - Required - The amount to prepay in USDC. ### Response #### Success Response (200) - **balance** (number) - The new account balance. ``` -------------------------------- ### POST /api/account/plans Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-phone/SKILL.md Leases a phone number for a month. The number can receive texts and place calls, and is yours for the term. ```APIDOC ## [POST] /api/account/plans ### Description Leases a phone number for a month. The number can receive texts and place calls, and is yours for the term. ### Method POST ### Endpoint https://agentgates.ai/api/account/plans ### Parameters #### Request Body - **plan** (string) - Required - The plan identifier for the number lease. ### Response #### Success Response (200) - **number** (string) - The leased phone number. - **term** (string) - The term of the lease (e.g., "1 month"). ``` -------------------------------- ### POST /api/compute/deployments Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-compute/SKILL.md Creates a new deployment by purchasing compute time. The request body must include the plan, hours, and either a compose file or an image, along with optional environment variables and a name. ```APIDOC ## [POST] /api/compute/deployments ### Description Creates a new deployment by purchasing compute time. The request body must include the plan, hours, and either a compose file or an image, along with optional environment variables and a name. ### Method POST ### Endpoint https://api.agentgates.ai/api/compute/deployments ### Parameters #### Request Body - **plan** (string) - Required - The plan identifier. - **hours** (number) - Required - Number of hours to rent. - **compose** (string) - Optional - Docker compose file content. - **image** (string) - Optional - Docker image name. - **env** (object) - Optional - Environment variables. - **name** (string) - Optional - Deployment name. ``` -------------------------------- ### curl: place a payphone call with task Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-phone/SKILL.md POST to https://agentgates.ai/api/booth to place a call. Expect a 402 response; sign and retry. The call is placed from a house number and nothing is stored. ```bash curl -s -X POST https://agentgates.ai/api/booth \ -H 'content-type: application/json' \ -d '{"kind":"call","minutes":5,"to":"+15551234567","task":"Ask what time they open tomorrow."}' # 402, sign, retry ``` -------------------------------- ### POST /api/booth Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-phone/SKILL.md Places a real phone call paid in USDC over x402. The call is placed from a house number and nothing is stored or renewed. ```APIDOC ## [POST] /api/booth ### Description Places a real phone call paid in USDC over x402. The call is placed from a house number and nothing is stored or renewed. ### Method POST ### Endpoint https://agentgates.ai/api/booth ### Parameters #### Request Body - **kind** (string) - Required - The type of request, must be "call". - **minutes** (number) - Required - The number of minutes to purchase for the call. - **to** (string) - Required - The phone number to dial, in E.164 format. - **task** (string) - Optional - A natural language task for the operator to perform during the call. - **streamUrl** (string) - Optional - A WebSocket URL for bidirectional audio streaming. - **say** (string) - Optional - A short spoken line to say before the person is connected. ### Response #### Success Response (200) - **status** (string) - The result of the call. - **transcript** (string) - The transcript of the call, if a task was provided. - **outcome** (string) - The outcome of the call, if a task was provided. ### Request Example ```bash curl -s -X POST https://agentgates.ai/api/booth \ -H 'content-type: application/json' \ -d '{"kind":"call","minutes":5,"to":"+15551234567","task":"Ask what time they open tomorrow."}' ``` ``` -------------------------------- ### POST /api/inference/credits Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-inference/SKILL.md Prepay a balance to cover multiple requests with a single on-chain settlement. After prepaying, you can use X-Wallet-Auth or mint bearer API keys for authentication. ```APIDOC ## POST /api/inference/credits ### Description Prepay a balance to cover multiple requests with a single on-chain settlement. After prepaying, you can use X-Wallet-Auth or mint bearer API keys for authentication. ### Method POST ### Endpoint https://api.agentgates.ai/api/inference/credits ### Parameters #### Request Body - **amount** (number) - Required - The amount of USDC to prepay. ### Response #### Success Response (200) - **balance** (number) - The new prepaid balance. - **wallet** (string) - The wallet address associated with the balance. ``` -------------------------------- ### POST /api/booth - payphone call without account Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-voice/SKILL.md Use the payphone endpoint to place a call without an account, paying via x402. Request body includes `kind`, `minutes`, `to`, and `task`. ```http POST /api/booth {"kind":"call","minutes":5,"to":"+1…","task":"…"} ``` -------------------------------- ### POST /api/booth Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-voice/SKILL.md Places a phone call without an account, using the payphone over x402. Specify the number of minutes and the task. ```APIDOC ## [POST] /api/booth ### Description Places a phone call without an account, using the payphone over x402. Specify the number of minutes and the task. ### Method POST ### Endpoint /api/booth ### Parameters #### Request Body - **kind** (string) - Required - Must be "call" - **minutes** (integer) - Required - Number of minutes to reserve - **to** (string) - Required - Destination phone number - **task** (string) - Required - The task to be accomplished in words ### Response #### Success Response (201) - **callId** (string) - Identifier of the created call - **call** (object) - Call details - **perMinuteUsd** (number) - Price per minute in USD ``` -------------------------------- ### POST /api/inference/chat Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-inference/SKILL.md Sends a chat request to a model. Requires a payment via x402 (either by including an X-PAYMENT header with a signed authorization or by using a prepaid balance with X-Wallet-Auth). Returns the model's completion and settlement details. ```APIDOC ## POST /api/inference/chat ### Description Sends a chat request to a model. Requires a payment via x402 (either by including an X-PAYMENT header with a signed authorization or by using a prepaid balance with X-Wallet-Auth). Returns the model's completion and settlement details. ### Method POST ### Endpoint https://api.agentgates.ai/api/inference/chat ### Parameters #### Request Body - **model** (string) - Required - The model identifier to use. - **messages** (array) - Required - The chat messages in standard chat format. - **max_tokens** (integer) - Required - The maximum number of tokens to generate. ### Headers - **X-PAYMENT** (string) - Optional - The EIP-3009 TransferWithAuthorization signature for the payment. - **X-Wallet-Auth** (string) - Optional - Wallet authentication header for prepaid balance usage. ### Response #### Success Response (200) - **completion** (object) - The model's response, including content and finish reason. - **settlement** (object) - Details of the payment settlement. #### Error Response (402) - **accepts** (array) - List of payment offers, each containing network-specific pricing for the request body. ``` -------------------------------- ### Place a call from terminal with agentgates call Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-voice/SKILL.md Use the CLI to place a call by specifying the phone number and task. Then use `agentgates calls --wait` to retrieve the transcript and outcome. ```bash agentgates call +15551234567 "book a table for two at 8pm" ``` ```bash agentgates calls --wait ``` -------------------------------- ### POST /api/inboxes/{id}/wait-code Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-email/SKILL.md Blocks until a verification code from a sign-up email arrives in the inbox, then returns the code. ```APIDOC ## POST /api/inboxes/{id}/wait-code ### Description Blocks until a verification code from a sign-up email arrives in the inbox, then returns the code. ### Method POST ### Endpoint /api/inboxes/{id}/wait-code ### Authentication Owner-signed (X-Wallet-Auth or Authorization: Bearer agk_…) ### Parameters #### Path Parameters - **id** (string) - Required - The inbox ID. ``` -------------------------------- ### POST /api/calls Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-voice/SKILL.md Places a phone call from the house number. Provide the destination number and the task in words; the operator will dial and handle the call. ```APIDOC ## [POST] /api/calls ### Description Places a phone call from the house number. Provide the destination number and the task in words; the operator will dial and handle the call. ### Method POST ### Endpoint /api/calls ### Parameters #### Request Body - **to** (string) - Required - Destination phone number - **task** (string) - Required - The task to be accomplished in words - **persona** (string) - Optional - Persona to use for the call - **greeting** (string) - Optional - Greeting to use for the call ### Response #### Success Response (201) - **callId** (string) - Identifier of the created call - **call** (object) - Call details - **perMinuteUsd** (number) - Price per minute in USD ``` -------------------------------- ### POST /api/calls - owner-signed call from house number Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-voice/SKILL.md Owner-signed HTTP request to place a call from the house number. Accepts `to`, `task`, optional `persona` and `greeting`. Responds with `201` and `{"callId","call","perMinuteUsd"}`. ```http POST /api/calls {"to","task","persona"?,"greeting"?} ``` -------------------------------- ### POST /api/phones/{id}/calls Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-voice/SKILL.md Places a phone call from a specific phone number you hold. Provide the destination number and the task in words. ```APIDOC ## [POST] /api/phones/{id}/calls ### Description Places a phone call from a specific phone number you hold. Provide the destination number and the task in words. ### Method POST ### Endpoint /api/phones/{id}/calls ### Parameters #### Path Parameters - **id** (string) - Required - Identifier of the phone number to call from #### Request Body - **to** (string) - Required - Destination phone number - **task** (string) - Required - The task to be accomplished in words - **persona** (string) - Optional - Persona to use for the call - **greeting** (string) - Optional - Greeting to use for the call ### Response #### Success Response (201) - **callId** (string) - Identifier of the created call - **call** (object) - Call details - **perMinuteUsd** (number) - Price per minute in USD ``` -------------------------------- ### POST /api/phones/{id}/calls - owner-signed call from held number Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-voice/SKILL.md Owner-signed HTTP request to place a call from a number you hold. Accepts `to`, `task`, optional `persona` and `greeting`. Responds with `201` and `{"callId","call","perMinuteUsd"}`. ```http POST /api/phones/{id}/calls {"to","task","persona"?,"greeting"?} ``` -------------------------------- ### POST /api/inboxes Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-email/SKILL.md Creates a new email inbox owned by the account. The request body may include an optional name; the response returns the inbox ID and address. ```APIDOC ## POST /api/inboxes ### Description Creates a new email inbox owned by the account. The request body may include an optional name; the response returns the inbox ID and address. ### Method POST ### Endpoint /api/inboxes ### Authentication Owner-signed (X-Wallet-Auth or Authorization: Bearer agk_…) ### Request Body - **name** (string) - Optional - The display name for the inbox. ### Request Example ```json {"name": "maria lopez"} ``` ### Response #### Success Response (201) - **inbox** (object) - Contains the inbox ID and address. #### Response Example ```json {"inbox": {"id","address"}} ``` ``` -------------------------------- ### POST /api/inboxes/{id}/send Source: https://github.com/agentgates-ai/agentgates/blob/main/skills/agentgates-email/SKILL.md Sends an email from the specified inbox. The request body contains the recipient, subject, and text. ```APIDOC ## POST /api/inboxes/{id}/send ### Description Sends an email from the specified inbox. The request body contains the recipient, subject, and text. ### Method POST ### Endpoint /api/inboxes/{id}/send ### Authentication Owner-signed (X-Wallet-Auth or Authorization: Bearer agk_…) ### Parameters #### Path Parameters - **id** (string) - Required - The inbox ID. ### Request Body - **to** (string) - Required - The recipient email address. - **subject** (string) - Required - The email subject. - **text** (string) - Required - The email body text. ### Request Example ```json {"to","subject","text"} ``` ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.