{
  "markdown": "# JustHandled Agent Client\n\nA guarded CLI, JavaScript client, and local MCP server for the [JustHandled Agent Utility Gateway](https://justhandledlabs.com/agent-gateway/). The package exposes thirty-two preflights, maintained-data lookups, and evidence products. Twenty-two products cost $0.05 USDC; ten evidence-heavy or maintained-data products cost $0.25, including the live Chicago Contract Change Packet. Every paid call returns a versioned evidence receipt.\n\nThe client fails closed before signing. It accepts only the pinned JustHandled gateway, Base mainnet, canonical Base USDC, the exact per-product price, and the published merchant receiver. Customer inputs and complete customer results are not persisted by the gateway; maintained public-source snapshots are labeled in the receipt.\n\n## Inspect without a wallet\n\n```bash\nnpx --package @justhandledlabs/agent-client justhandled-agent catalog\nnpx --package @justhandledlabs/agent-client justhandled-agent preview filename-portability-preflight --json '{\"paths\":[\"CON.txt\"]}'\nnpx --package @justhandledlabs/agent-client justhandled-agent preview agent-run-evidence-pack --file agent-run-evidence-pack.sample.json\nnpx --package @justhandledlabs/agent-client justhandled-agent preview agent-distribution-readiness-pack --file agent-distribution-readiness-pack.sample.json\nnpx --package @justhandledlabs/agent-client justhandled-agent preview community-rule-credibility-preflight --file community-rule-credibility-preflight.sample.json\nnpx --package @justhandledlabs/agent-client justhandled-agent preview qualified-demand-ledger --file qualified-demand-ledger.sample.json\nnpx --package @justhandledlabs/agent-client justhandled-agent preview channel-fit-evidence-matrix --file channel-fit-evidence-matrix.sample.json\nnpx --package @justhandledlabs/agent-client justhandled-agent preview proof-to-channel-evidence-packet --file proof-to-channel-evidence-packet.sample.json\nnpx --package @justhandledlabs/agent-client justhandled-agent preview channel-experiment-postmortem --file channel-experiment-postmortem.sample.json\nnpx --package @justhandledlabs/agent-client justhandled-agent preview chicago-contract-change-packet --file chicago-contract-change-packet.sample.json\n```\n\nPreview performs an unpaid request and validates the returned x402 terms. It does not sign or spend.\n\nThe catalog includes API-response contract drift, webhook contract and replay, and policy-change evidence products. Packaged example inputs are available in `examples/`.\n\nMachine-readable products, exact payment terms, and free deterministic fixtures are available from the gateway's [product catalog](https://justhandled-agent-gateway.netlify.app/api/product-catalog), [OpenAPI document](https://justhandled-agent-gateway.netlify.app/openapi.json), and [sandbox index](https://justhandled-agent-gateway.netlify.app/sandbox/index.json).\n\n## Execute one paid utility\n\nUse a dedicated low-balance Base wallet. Never provide a primary wallet key.\n\n```bash\nexport JH_EVM_PRIVATE_KEY=0x...\nnpx --package @justhandledlabs/agent-client justhandled-agent call filename-portability-preflight --json '{\"paths\":[\"CON.txt\"]}'\n```\n\nPowerShell:\n\n```powershell\n$env:JH_EVM_PRIVATE_KEY = \"0x...\"\nnpx.cmd --package @justhandledlabs/agent-client justhandled-agent call filename-portability-preflight --json '{\"paths\":[\"CON.txt\"]}'\n```\n\n## MCP configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"justhandled\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@justhandledlabs/agent-client\"],\n      \"env\": {\n        \"JH_EVM_PRIVATE_KEY\": \"0xDEDICATED_LOW_BALANCE_WALLET_KEY\"\n      }\n    }\n  }\n}\n```\n\nThe MCP server exposes a free catalog tool plus one paid tool per gateway utility. Missing wallet configuration produces an error instead of a payment attempt.\n\nThe package declares the official MCP Registry identity `io.github.justhandledlabs/agent-gateway`. Registry identity is discovery metadata only: installing or listing the server does not spend funds, and paid execution still requires a dedicated wallet plus the client's exact-term checks.\n\n## Security model\n\n- Price, chain, asset, receiver, and gateway origin are pinned in code.\n- The ten $0.25 products' 250,000-base-unit price is pinned separately from 50,000-base-unit checks.\n- Every execution starts with an unpaid 402 preview.\n- A mismatched term aborts before signing.\n- The package never prints the private key.\n- The gateway does not persist customer inputs or complete customer results. Maintained-data products may retain normalized public-source snapshots and disclose that state in the receipt.\n- Treat all crypto transfers as irreversible and fund only a dedicated wallet.\n\n## Development\n\n```bash\nnpm install\nnpm run check\n```\n\nThe gateway implementation is intentionally not included in this client repository.\n",
  "bytes": 4804,
  "sha": "503e5edf84dde214630f1fd6de8c5d0a253e2ab18b223ad3093fe8448e94b2e1",
  "repo_slug": "justhandledlabs/justhandled-agent-client",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_justhandledlabs_agent_gateway_7b84dc2f/readme"
}