> ## Documentation Index
> Fetch the complete documentation index at: https://agentcash.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# check_endpoint_schema

> Probe an endpoint for pricing, auth requirements, and schema without paying.

The `check_endpoint_schema` tool inspects an endpoint to learn its price, supported methods, input/output schema, and auth mode without making a payment.

Equivalent CLI command: `npx agentcash check <url>`

## Parameters

<ParamField body="url" type="string" required>
  The endpoint URL to check.
</ParamField>

<ParamField body="method" type="string">
  Specific HTTP method to probe. If omitted, AgentCash probes multiple methods and checks the OpenAPI spec.
</ParamField>

<ParamField body="headers" type="string[]">
  Additional headers to include. Each entry must use `Name: value` format.
</ParamField>

## Response

<ResponseField name="price" type="string">
  Cost per request in USDC.
</ResponseField>

<ResponseField name="methods" type="string[]">
  Supported HTTP methods (GET, POST, etc.).
</ResponseField>

<ResponseField name="inputSchema" type="object">
  Expected request body format (JSON schema).
</ResponseField>

<ResponseField name="outputSchema" type="object">
  Response body format (JSON schema).
</ResponseField>

<ResponseField name="authType" type="string">
  Authentication mode: `x402`, `siwx`, `mpp`, or `none`.
</ResponseField>

## Behavior

1. Sends a probe request to the endpoint
2. Reads the `402 Payment Required` response for pricing and auth details
3. Fetches the OpenAPI spec (if available) for schema information
4. Probes multiple HTTP methods in parallel to determine which are supported
5. Returns all metadata without making a payment

## Example

Ask your agent:

> Check the pricing and schema for [https://stableenrich.dev/api/company/lookup](https://stableenrich.dev/api/company/lookup) using AgentCash.