Skip to main content

​
fetch

npx agentcash fetch <url> [options]
Sends an HTTP request with automatic SIWX authentication and payment handling. If the endpoint returns 402, AgentCash attempts SIWX first and only pays if the route still requires it. Equivalent to the MCP fetch tool.
Run check <url> first to confirm the request body schema. Skipping this often causes 400 errors from wrong field names.

​
Options

FlagDescription
-m / --method <method>HTTP method (default: GET)
-b / --body <string>Raw request body string, passed through as-is
-H / --header <name:value>HTTP header in Name: value format (repeatable)
--timeout <ms>Request timeout in milliseconds
--payment-protocol <protocol>Force a specific payment protocol: x402 or mpp
--payment-network <network>Preferred network for SIWX and payment when applicable
--max-amount <usd>Abort if the payment challenge exceeds this amount

​
Example

npx agentcash fetch https://stableenrich.dev/api/apollo/people-enrich \
  -m POST \
  -b '{"email":"user@example.com"}'

​
fetch-auth

npx agentcash fetch-auth <url> [options]
Deprecated alias for fetch. It uses the same unified flow and accepts the same options, but new integrations should call fetch directly.

​
check

npx agentcash check <url> [options]
Gets the input/output schema and auth mode (paid or SIWX) for an endpoint. Returns exact field names from the OpenAPI spec. Equivalent to the MCP check_endpoint_schema tool. Call this before fetch to avoid 400 errors from wrong field names.

​
Options

FlagDescription
-H / --header <name:value>HTTP header in Name: value format (repeatable)
-b / --body <json>Probe the endpoint live for an exact price quote (useful when pricing is range-based)

​
Example

npx agentcash check https://stableenrich.dev/api/apollo/people-enrich

​
discover

npx agentcash discover <url> [options]
Lists available endpoints at an API origin with descriptions and auth modes (paid or SIWX). Works with any origin, not just registered ones. Equivalent to the MCP discover_api_endpoints tool.

​
Options

FlagDescription
--include-guidanceReturn full provider documentation (useful when composing multiple endpoints or when usage is unclear)

​
Example

npx agentcash discover https://stableenrich.dev

​
try

npx agentcash try <url>
Fetches a new origin’s resources and returns a prompt guiding you through calling the first endpoint. Good for exploring an unfamiliar origin.

​
register

npx agentcash register <url>
Registers an origin with AgentCash by discovering and indexing its endpoints.

​
Example

npx agentcash register https://stableenrich.dev