# AgentExec
> On-chain execution gateway and WebMCP tool discovery for autonomous AI agents on Base Mainnet (8453).

## Protocol & Specification
- [Website](https://agentexec.dev): Developer landing page.
- [Live sandbox](https://agentexec.dev/demo): Keyless 402 inspect + eth_estimateGas dry-run. No funds move.
- [Terms of Service](https://agentexec.dev/terms): Developer terms. On-chain x402 USDC only (no Paddle/card billing).
- [Privacy Policy](https://agentexec.dev/privacy): Request logs and on-chain payment data.
- [Refund Policy](https://agentexec.dev/refund): Paid calls settle in USDC on Base; unpaid 402s do not move funds.
- [Agent crawler spec](https://agentexec.dev/AGENTS.md): Interoperability notes for this domain.
- [Streamable HTTP MCP](https://api.agentexec.dev/mcp): JSON-RPC MCP (`initialize`, `tools/list`, `tools/call`). Discovery, not the paid execute route.
- [MCP client configs](https://agentexec.dev/docs/mcp): Cursor, Claude Desktop, and Claude Code snippets.
- [Paid execute](https://api.agentexec.dev/v1/intent/execute): HTTP 402 x402 v1 `accepts[]`. Retry with `PAYMENT-SIGNATURE`.
- [Gateway meta](https://api.agentexec.dev/v1/meta): Live network, payTo, price, allowlist, MCP URLs.
- [Source](https://github.com/Har50/agent1): Gateway, SDK, and `src/sdk/agentexec-client.ts`.

## Execution Requirements
- Protocol: x402 v1 (`x402Version: 1`, non-empty `accepts[]`, scheme `exact`)
- Paid paths: `/v1/intent/execute`, `/v1/intents/execute`, `/v1/paid/*`
- Settlement asset: Base USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`)
- Payee (`payTo`): `0xe03ff418e2BaF1dFEF1f7906F04d43BFBcECaf99`
- Price: $0.01 USDC (`10000` atomic units, 6 decimals)
- Signature: EIP-3009 `TransferWithAuthorization` (USDC domain name `USD Coin`, version `2`, chainId `8453`)
- Proof header: `PAYMENT-SIGNATURE` — base64 JSON `{ "signature": "0x…", "payload": { "from", "to", "value", "validAfter", "validBefore", "nonce" } }`
- Challenge header: `PAYMENT-REQUIRED` — base64 JSON of the same 402 object as the body
- Drain cap: $5.00 USDC per intent. Execute allowlist is `DEFAULT_ALLOWED_TARGETS` (production: Base USDC).
- `/mcp` is Streamable HTTP JSON-RPC. Do not POST a generic JSON body there expecting a 402 execute challenge.

## Network
- Network: Base Mainnet (chain ID 8453)
- [Base explorer](https://basescan.org): On-chain verification.
- [x402-list](https://x402-list.com/services/agentexec): Listed / payment-ready (not directory-verified).
- [Smithery](https://smithery.ai/servers/@Har50/agentexec): `@Har50/agentexec`
- MCP registry name: `io.github.Har50/gateway`