agentcash fetch, check, discover, search

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. Output includes all headers from the final endpoint response in result metadata (or error details for an HTTP error). This preserves raw MPP payment-receipt and x402 payment-response / x-payment-response proof when the server supplies it.

Run check <url> first to confirm the request body schema. Skipping this often causes 400 errors from wrong field names.

Options

Flag	Description
`-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/pdl/people-enrich \
  -m POST \
  -b '{"profile":"https://www.linkedin.com/in/example"}'

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

Flag	Description
`-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/fullenrich/people-search

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

Flag	Description
`--include-guidance`	Return full provider documentation (useful when composing multiple endpoints or when usage is unclear)

Example

npx agentcash discover https://stableenrich.dev

search

npx agentcash search "<query>"

Finds paid API services by natural-language query. Returns matching origins with endpoints and pricing. Use this to find an API before you know which origin to call. Equivalent to the MCP search tool.

Example

npx agentcash search "send a physical postcard"

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

CLI

MCP tools

agentcash fetch, check, discover, search

fetch

Options

Example

fetch-auth

check

Options

Example

discover

Options

Example

search

Example

try

register

Example

​fetch

​Options

​Example

​fetch-auth

​check

​Options

​Example

​discover

​Options

​Example

​search

​Example

​try

​register

​Example

fetch

Options

Example

fetch-auth

check

Options

Example

discover

Options

Example

search

Example

try

register

Example