{"_id":"@agonx402/agentic","_rev":"10-49462b5c86f12eac7d010a27e16f063b","name":"@agonx402/agentic","dist-tags":{"latest":"0.4.2"},"versions":{"0.1.0":{"name":"@agonx402/agentic","version":"0.1.0","keywords":["agon","x402","solana","agents","skills","payment-channels"],"license":"MIT","_id":"@agonx402/agentic@0.1.0","maintainers":[{"name":"agonx402","email":"contact@agonx402.com"}],"homepage":"https://github.com/Agonx402/agon-gateway-agentic#readme","bugs":{"url":"https://github.com/Agonx402/agon-gateway-agentic/issues"},"bin":{"agonx402-agentic":"install.js"},"dist":{"shasum":"a7410ae7ce7e91446ec86db784dd6ec2b3a2451d","tarball":"https://registry.npmjs.org/@agonx402/agentic/-/agentic-0.1.0.tgz","fileCount":14,"integrity":"sha512-C7IHfuAP7A8+q/2G1uZr4t2caH/Ozc9N5i7VjyAWFUW6ccr9PSD3drl0uzt81uqtyFxOwmQR7ZvVZDvQfrrCzw==","signatures":[{"sig":"MEYCIQCQSh8LcFWOyk5zccYAqKs0MGmgMOQXA1CAIlvifx3TnQIhAJ/s26KgtYeGJOTOU626iD7/4QzQgmiCwUVb1QAvqiDS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64558},"engines":{"node":">=18"},"gitHead":"23688fb5547ba9a5819a99b2d80c046ac9938247","scripts":{"check":"node --check install.js","start":"node install.js","prepack":"npm run check"},"_npmUser":{"name":"agonx402","email":"contact@agonx402.com"},"repository":{"url":"git+https://github.com/Agonx402/agon-gateway-agentic.git","type":"git"},"_npmVersion":"10.9.0","description":"Installer for Agon Gateway and Agon Protocol agent skills.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentic_0.1.0_1777497210874_0.1717402170428579","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@agonx402/agentic","version":"0.1.1","keywords":["agon","x402","solana","agents","skills","payment-channels"],"license":"MIT","_id":"@agonx402/agentic@0.1.1","maintainers":[{"name":"agonx402","email":"contact@agonx402.com"}],"homepage":"https://github.com/Agonx402/agon-gateway-agentic#readme","bugs":{"url":"https://github.com/Agonx402/agon-gateway-agentic/issues"},"bin":{"agonx402-agentic":"install.js"},"dist":{"shasum":"f911f95c2b5ea42deda243031f84119d1ebed63c","tarball":"https://registry.npmjs.org/@agonx402/agentic/-/agentic-0.1.1.tgz","fileCount":14,"integrity":"sha512-rCk4//flz5utmyacH+Xfy1emNQsNddkz6TkM/GaOEb1r6v+wwQmhv2RhYk3zNsKF8Jel+kcuYS6CSr/iyAiBDw==","signatures":[{"sig":"MEUCIAJ9id4+asnN/LWKiKw03lsJb5wsSxDxDhadfsVNrG3oAiEArXdY2GTfoMUqwNuxH9g58Yh93P6hAJBy6JOJ3dKZRrc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":71577},"engines":{"node":">=18"},"gitHead":"ba6be2fe995a3f294c87583b5cdc14dc984bea43","scripts":{"check":"node --check install.js","start":"node install.js","prepack":"npm run check"},"_npmUser":{"name":"agonx402","email":"contact@agonx402.com"},"repository":{"url":"git+https://github.com/Agonx402/agon-gateway-agentic.git","type":"git"},"_npmVersion":"10.9.0","description":"Installer for Agon Gateway and Agon Protocol agent skills.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentic_0.1.1_1777501342576_0.33988037184580144","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@agonx402/agentic","version":"0.1.2","keywords":["agon","x402","solana","agents","skills","payment-channels"],"license":"MIT","_id":"@agonx402/agentic@0.1.2","maintainers":[{"name":"agonx402","email":"contact@agonx402.com"}],"homepage":"https://github.com/Agonx402/agon-gateway-agentic#readme","bugs":{"url":"https://github.com/Agonx402/agon-gateway-agentic/issues"},"bin":{"agonx402-agentic":"install.js"},"dist":{"shasum":"0cbf1bf803478e0ca968c90e58b3b246a1f899c6","tarball":"https://registry.npmjs.org/@agonx402/agentic/-/agentic-0.1.2.tgz","fileCount":14,"integrity":"sha512-yCo07dtMKTB91ke/Kne1mad1iKpzSpLQOajg+M/I0/6rsLnmD7KsXsQWzmnbGV4mPy9EE30dgDf2Z19xP9OHxw==","signatures":[{"sig":"MEYCIQD+0lKv+EIWWPT/0BZzrF+Kb8n/3hBDPod19gtUo5Bq2QIhAMJsYsDK2QzlwsFmstMZDa2IRWWgOoHBRN3WKknw5FYi","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":85575},"engines":{"node":">=18"},"gitHead":"953d25d325f4e2094e91810cad774fcf75a3de97","scripts":{"check":"node --check install.js","start":"node install.js","prepack":"npm run check"},"_npmUser":{"name":"agonx402","email":"contact@agonx402.com"},"repository":{"url":"git+https://github.com/Agonx402/agon-gateway-agentic.git","type":"git"},"_npmVersion":"10.9.0","description":"Installer for Agon Gateway and Agon Protocol agent skills, MCP servers, and signer hooks.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentic_0.1.2_1777544680601_0.1623880504957831","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@agonx402/agentic","version":"0.1.3","keywords":["agon","x402","solana","agents","skills","payment-channels"],"license":"MIT","_id":"@agonx402/agentic@0.1.3","maintainers":[{"name":"agonx402","email":"contact@agonx402.com"}],"homepage":"https://github.com/Agonx402/agon-gateway-agentic#readme","bugs":{"url":"https://github.com/Agonx402/agon-gateway-agentic/issues"},"bin":{"agonx402-agentic":"install.js"},"dist":{"shasum":"1db14bc4e277884fced855686e5066b23c19bcd5","tarball":"https://registry.npmjs.org/@agonx402/agentic/-/agentic-0.1.3.tgz","fileCount":14,"integrity":"sha512-z3xyLFqiH+sMuTNiY1K7lzbkGTI6qEhlJ4UNCrp/iWEfwsXpVPU000lkbquYt1cYmbHi1VTqe7amKCiTszI8FA==","signatures":[{"sig":"MEYCIQCAESdI1+dOXjZkvRiUqZ1XP6I6J1/bqXQgn+2OprFrswIhALln1ts2SgZy9pbGSkTUZmWJBUoPmgB4WBuJAIrlwNZY","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":95508},"engines":{"node":">=18"},"gitHead":"953d25d325f4e2094e91810cad774fcf75a3de97","scripts":{"check":"node --check install.js","start":"node install.js","prepack":"npm run check"},"_npmUser":{"name":"agonx402","email":"contact@agonx402.com"},"repository":{"url":"git+https://github.com/Agonx402/agon-gateway-agentic.git","type":"git"},"_npmVersion":"10.9.0","description":"Installer for Agon Gateway and Agon Protocol agent skills, default wallet setup, MCP servers, and signer hooks.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentic_0.1.3_1777546423629_0.9335699484708808","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@agonx402/agentic","version":"0.3.0","keywords":["agon","x402","solana","agents","skills","payment-channels"],"license":"MIT","_id":"@agonx402/agentic@0.3.0","maintainers":[{"name":"agonx402","email":"contact@agonx402.com"}],"homepage":"https://github.com/Agonx402/agon-gateway-agentic#readme","bugs":{"url":"https://github.com/Agonx402/agon-gateway-agentic/issues"},"bin":{"agonx402-agentic":"install.js"},"dist":{"shasum":"1119bf4f6f8cd5b3dfa22e370df79b8054aba0e6","tarball":"https://registry.npmjs.org/@agonx402/agentic/-/agentic-0.3.0.tgz","fileCount":14,"integrity":"sha512-fESL+ayraZSEIi7+mgxmr75l49DqjI8HwrOHn6p2bzm6GYrteivRQHbdPOFoDB0MZkdDF7RHjJnSZNTvOHuuSg==","signatures":[{"sig":"MEYCIQCpfa+qmJ+XKr3QKT7tvfo8Top67zTIf/Kx6943Q2Wv+gIhAMBvK+npgDezejkjrH7Bhn4Uy9Ao3sxRQdqFdIPSi3xS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":105320},"engines":{"node":">=18"},"gitHead":"953d25d325f4e2094e91810cad774fcf75a3de97","scripts":{"check":"node --check install.js","start":"node install.js","prepack":"npm run check"},"_npmUser":{"name":"agonx402","email":"contact@agonx402.com"},"repository":{"url":"git+https://github.com/Agonx402/agon-gateway-agentic.git","type":"git"},"_npmVersion":"10.9.0","description":"Installer for Agon Gateway and Agon Protocol agent skills, default SIWX signer wallet, MCP servers, and signer hooks.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentic_0.3.0_1777573743770_0.5418989474208054","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@agonx402/agentic","version":"0.3.1","keywords":["agon","x402","solana","agents","skills","payment-channels"],"license":"MIT","_id":"@agonx402/agentic@0.3.1","maintainers":[{"name":"agonx402","email":"contact@agonx402.com"}],"homepage":"https://github.com/Agonx402/agon-gateway-agentic#readme","bugs":{"url":"https://github.com/Agonx402/agon-gateway-agentic/issues"},"bin":{"agonx402-agentic":"install.js"},"dist":{"shasum":"37bf38583e8030d4a8acd305266b7132047191ce","tarball":"https://registry.npmjs.org/@agonx402/agentic/-/agentic-0.3.1.tgz","fileCount":14,"integrity":"sha512-GjGCPAO2y6tkjZCtyBfUMhRgyrtL/u22pXkGKsWfp6Bd6THU3LUed7M/jTHcSVOPNodUjbTBIXXgCxfTuxpmdA==","signatures":[{"sig":"MEYCIQCP3OPCwfOF0lb7aPIz6IaMw7cwv19og9pEkL0FT2FMVgIhAL4/eZ1OAmf+KIVasQIOe2NSZLOroSlIhvo9HuI5o9lq","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":108707},"engines":{"node":">=18"},"gitHead":"953d25d325f4e2094e91810cad774fcf75a3de97","scripts":{"check":"node --check install.js","start":"node install.js","prepack":"npm run check"},"_npmUser":{"name":"agonx402","email":"contact@agonx402.com"},"repository":{"url":"git+https://github.com/Agonx402/agon-gateway-agentic.git","type":"git"},"_npmVersion":"10.9.0","description":"Installer for Agon Gateway and Agon Protocol agent skills, default SIWX signer wallet, MCP servers, and signer hooks.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentic_0.3.1_1777648980774_0.5969973870329244","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"@agonx402/agentic","version":"0.3.2","keywords":["agon","x402","solana","agents","skills","payment-channels"],"license":"MIT","_id":"@agonx402/agentic@0.3.2","maintainers":[{"name":"agonx402","email":"contact@agonx402.com"}],"homepage":"https://github.com/Agonx402/agon-gateway-agentic#readme","bugs":{"url":"https://github.com/Agonx402/agon-gateway-agentic/issues"},"bin":{"agonx402-agentic":"install.js"},"dist":{"shasum":"99645bc47bc708803386848d95dad41b7f571ff6","tarball":"https://registry.npmjs.org/@agonx402/agentic/-/agentic-0.3.2.tgz","fileCount":14,"integrity":"sha512-zTbU9Dvh3GGGSHjOCRyJvi8KWv2sQlL9h3Tw6A76cr25XDTnjVNpATai8uvdgSz9lu1K/0BcAtNekGJ9BdR+bQ==","signatures":[{"sig":"MEYCIQDt7aKeuf/St7gCADQTzdQd0gXu/jU8/uC4tzszZ5RpKQIhAOIJoh5JJjLqEEGZEMHQhm5GE2IAaKyyf7WCXs+w3u7l","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":119317},"engines":{"node":">=18"},"gitHead":"982531c16e511b30d6d4856069c8352befe06aa2","scripts":{"check":"node --check install.js","start":"node install.js","prepack":"npm run check"},"_npmUser":{"name":"agonx402","email":"contact@agonx402.com"},"repository":{"url":"git+https://github.com/Agonx402/agon-gateway-agentic.git","type":"git"},"_npmVersion":"10.9.0","description":"Installer for Agon Gateway and Agon Protocol agent skills, default SIWX signer wallet, MCP servers, and signer hooks.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentic_0.3.2_1777652577752_0.6536342848369021","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@agonx402/agentic","version":"0.4.0","keywords":["agon","x402","solana","agents","skills","payment-channels"],"license":"MIT","_id":"@agonx402/agentic@0.4.0","maintainers":[{"name":"agonx402","email":"contact@agonx402.com"}],"homepage":"https://github.com/Agonx402/agon-gateway-agentic#readme","bugs":{"url":"https://github.com/Agonx402/agon-gateway-agentic/issues"},"bin":{"agonx402-agentic":"install.js"},"dist":{"shasum":"f86c344b0533934c9613262b1cc08a6d0b5831bc","tarball":"https://registry.npmjs.org/@agonx402/agentic/-/agentic-0.4.0.tgz","fileCount":14,"integrity":"sha512-2+ux9a29fFK1AwMDMH0/IE5gpW432RbTaeknCBDwRrauA25bTqqv8Sm0XMUabOdhFc1NAecGwZZhmaAZCSnm9Q==","signatures":[{"sig":"MEYCIQCt0p9T7jtbstTbmJC5fa9lyol5Fpr1ILzMCnIoCZr25wIhANylCD67FAkl89iptLLY/BaPIK4II0u3UlSuztfNsEf/","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":121299},"engines":{"node":">=18"},"gitHead":"21380f5432c1edd8a4597905ae7ccaf17db4ba50","scripts":{"check":"node --check install.js","start":"node install.js","prepack":"npm run check"},"_npmUser":{"name":"agonx402","email":"contact@agonx402.com"},"repository":{"url":"git+https://github.com/Agonx402/agon-gateway-agentic.git","type":"git"},"_npmVersion":"10.9.0","description":"Installer for Agon Gateway and Agon Protocol agent skills, default SIWX signer wallet, MCP servers, and signer hooks.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentic_0.4.0_1777664024476_0.775367723876951","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@agonx402/agentic","version":"0.4.1","keywords":["agon","x402","solana","agents","skills","payment-channels"],"license":"MIT","_id":"@agonx402/agentic@0.4.1","maintainers":[{"name":"agonx402","email":"contact@agonx402.com"}],"homepage":"https://github.com/Agonx402/agon-gateway-agentic#readme","bugs":{"url":"https://github.com/Agonx402/agon-gateway-agentic/issues"},"bin":{"agonx402-agentic":"install.js"},"dist":{"shasum":"633560be78c418434f4f1df3c8a0389a234b7945","tarball":"https://registry.npmjs.org/@agonx402/agentic/-/agentic-0.4.1.tgz","fileCount":14,"integrity":"sha512-S3oaMBEn8lHzGpp5+SsT6J68hJJhHxd8jowzvSjWUgf9TUSyqheXx1kD/rSEiQd2Sc8Lr/pTjg/0ckRb17qzCA==","signatures":[{"sig":"MEQCIDv3+Uu/BThYXvke6TfPDA9+TcSrpTQDcS0Shfz2HNfpAiAUAlMTwUmB9atZY7TLZsVEnZvLV04zGdUmNCFoRSO9Qw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":122475},"engines":{"node":">=18"},"gitHead":"83972bf1fa9849efc5c25ee09c016701894031ea","scripts":{"check":"node --check install.js","start":"node install.js","prepack":"npm run check"},"_npmUser":{"name":"agonx402","email":"contact@agonx402.com"},"repository":{"url":"git+https://github.com/Agonx402/agon-gateway-agentic.git","type":"git"},"_npmVersion":"10.9.0","description":"Installer for Agon Gateway and Agon Protocol agent skills, default SIWX signer wallet, MCP servers, and signer hooks.","directories":{},"_nodeVersion":"24.13.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agentic_0.4.1_1777666891170_0.2018640433041945","host":"s3://npm-registry-packages-npm-production"}},"0.4.2":{"name":"@agonx402/agentic","version":"0.4.2","description":"Installer for Agon Gateway and Agon Protocol agent skills, default SIWX signer wallet, MCP servers, and signer hooks.","license":"MIT","homepage":"https://github.com/Agonx402/agon-gateway-agentic#readme","repository":{"type":"git","url":"git+https://github.com/Agonx402/agon-gateway-agentic.git"},"bugs":{"url":"https://github.com/Agonx402/agon-gateway-agentic/issues"},"keywords":["agon","x402","solana","agents","skills","payment-channels"],"bin":{"agonx402-agentic":"install.js"},"engines":{"node":">=18"},"scripts":{"check":"node --check install.js","start":"node install.js","prepack":"npm run check"},"_id":"@agonx402/agentic@0.4.2","gitHead":"ff519d88f00ca2592b8f7296aac1efce97675d45","_nodeVersion":"24.13.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-Lo7xVYu3Nztra6WRXYcVRpvcP22F9Z04BxlwTHjaLRf0nukdi9fGkX7Z49XM6yHrzYfTuLF4i9UuSOBoBWSsPg==","shasum":"375b2dce240f220f3149509b142a615c84a81c77","tarball":"https://registry.npmjs.org/@agonx402/agentic/-/agentic-0.4.2.tgz","fileCount":14,"unpackedSize":122755,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCvibOXP8MCX5buMuZUqwJOsZmUbaMtO7LIA/pl2INd0wIhANPsZvp3QOKP0pS4hMYcoPv4bIvjK8XRJst2+BZmXRHX"}]},"_npmUser":{"name":"agonx402","email":"contact@agonx402.com"},"directories":{},"maintainers":[{"name":"agonx402","email":"contact@agonx402.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentic_0.4.2_1777737901328_0.8081940671509216"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-29T21:13:30.771Z","modified":"2026-05-02T16:05:02.001Z","0.1.0":"2026-04-29T21:13:31.034Z","0.1.1":"2026-04-29T22:22:22.734Z","0.1.2":"2026-04-30T10:24:40.740Z","0.1.3":"2026-04-30T10:53:43.795Z","0.3.0":"2026-04-30T18:29:03.922Z","0.3.1":"2026-05-01T15:23:00.914Z","0.3.2":"2026-05-01T16:22:57.908Z","0.4.0":"2026-05-01T19:33:44.618Z","0.4.1":"2026-05-01T20:21:31.291Z","0.4.2":"2026-05-02T16:05:01.601Z"},"bugs":{"url":"https://github.com/Agonx402/agon-gateway-agentic/issues"},"license":"MIT","homepage":"https://github.com/Agonx402/agon-gateway-agentic#readme","keywords":["agon","x402","solana","agents","skills","payment-channels"],"repository":{"type":"git","url":"git+https://github.com/Agonx402/agon-gateway-agentic.git"},"description":"Installer for Agon Gateway and Agon Protocol agent skills, default SIWX signer wallet, MCP servers, and signer hooks.","maintainers":[{"name":"agonx402","email":"contact@agonx402.com"}],"readme":"# Agon Agentic Tools\n\nAgent-facing tools for discovering, authenticating, and calling Agon Gateway routes.\n\n## One-Step Setup\n\n`setup --target all` is the one command that installs everything Agon agents need:\n\n- Bundled skills into `~/.agents/skills`, `~/.codex/skills`, `~/.claude/skills`.\n- Default SIWX signer wallet at `~/.agon/wallets/default.json`.\n- Global CLI bins on PATH: `agon`, `agon-gateway`, `agon-wallet`, `agon-protocol` (via `npm install -g @agonx402/gateway-cli @agonx402/agent-wallet @agonx402/protocol-cli`).\n- Local agent reference at `~/.agon/llm.txt`.\n- Agon MCP server registration for Codex, Claude Desktop, Claude Code, Cursor, Windsurf, and a generic config (existing entries preserved, backups written).\n\n```bash\nnpx -y @agonx402/agentic@latest setup --target all\n```\n\nAfter it finishes, restart your agent client and the agent can call Agon directly via:\n\n- The Agon MCP tools (`agon_token_quote`, `agon_token_resolve`, `agon_token_chart`, `agon_token_search`, `agon_token_batch_quote`, `agon_gateway_call`, `agon_gateway_auth_call`, ...).\n- The bare CLIs: `agon -p bitcoin`, `agon quote bitcoin solana usdt`, `agon-gateway auth call GET ...`, etc.\n\nOpt-out flags:\n\n- `--skip-global-cli` — do not run `npm install -g`. Bare CLI bins will not be on PATH; use `npx -y @agonx402/gateway-cli ...` instead.\n- `--skip-wallet-setup` — only valid for `install-skills` when another signer wallet is already configured.\n\nSupported setup targets:\n\n```bash\nnpx -y @agonx402/agentic setup --target codex            # ~/.codex/config.toml\nnpx -y @agonx402/agentic setup --target claude-desktop   # standalone Claude Desktop GUI app config\nnpx -y @agonx402/agentic setup --target claude-code      # ~/.claude.json (Claude Code CLI agent)\nnpx -y @agonx402/agentic setup --target cursor           # ~/.cursor/mcp.json\nnpx -y @agonx402/agentic setup --target windsurf\nnpx -y @agonx402/agentic setup --target generic          # ~/.agon/mcp.json\nnpx -y @agonx402/agentic setup --target all --dry-run\n```\n\n`--target all` writes to every adapter listed above. **Claude Desktop** (the standalone macOS/Windows GUI app) and **Claude Code** (the terminal CLI agent) read MCP servers from different files; `--target all` registers in both. After setup, restart your agent client so it re-reads the MCP server list.\n\nSetup creates `~/.agon/wallets/default.json`. `@agonx402/agent-wallet` **only signs Tokens API SIWX challenges** (`sign-in-with-x`). For Gateway routes that require **x402 exact payment** or other auth, set `AGON_SIGNER_COMMAND` to a signer that returns `PAYMENT-SIGNATURE` / `X-PAYMENT`.\n\n### When `AGON_SIGNER_COMMAND` runs\n\n- **Gateway MCP:** only when calling **`agon_gateway_auth_call`** and the gateway responds with **HTTP 402**. The MCP spawns `AGON_SIGNER_COMMAND` **once**, piping the normalized auth-request JSON to **stdin** (same shape as `agon_gateway_prepare_auth`). The process must exit 0 and print JSON to stdout: auth **headers**, or SIWX fallback (`address`, `signature`, optional `signatureEncoding`).\n- **`gateway-cli`:** **`agon-gateway auth call`** and **`batch`** reuse the same `requestGateway` path: **after any 402** from the Gateway, **`AGON_SIGNER_COMMAND`** (or **`--auth-driver`**) runs if set. **`auth prepare`** / **`doctor`** never spawn the signer.\n\nOn Windows, when the signer command begins with **`npx`/`npm`/`pnpm`/`yarn`**, Node may run it **via cmd shell**. Treat **`AGON_SIGNER_COMMAND`** as equivalent to trusting a shell snippet if an attacker controls it.\n\n## Skills And Wallet\n\nInstall all Agon skills into every supported agent skill directory (`~/.agents/skills`, `~/.codex/skills`, `~/.claude/skills`), and create the default convenience wallet used for SIWX/auth calls:\n\n```bash\nnpx -y @agonx402/agentic install-skills\n```\n\nOther install targets:\n\n```bash\nnpx -y @agonx402/agentic install-skills --target agents\nnpx -y @agonx402/agentic install-skills --target codex\nnpx -y @agonx402/agentic install-skills --target claude\nnpx -y @agonx402/agentic install-skills --target all\nnpx -y @agonx402/agentic list\nnpx -y @agonx402/agentic doctor\n```\n\nUse `--skip-wallet-setup` only when another signer wallet is already configured. The installer copies only the Agon skill folders, creates the target directory if needed, and overwrites only these Agon-owned skill names:\n\n- `agon-gateway`\n- `agon-protocol`\n- `agon-gateway-payment-channels`\n\n`install-skills` installs skills and creates `~/.agon/wallets/default.json`. `setup` performs skills, wallet, and MCP registration.\n\nAfter `setup --target all`, the CLI bins are on PATH. Use them directly:\n\n```bash\nagon -p bitcoin\nagon quote usdt --json\nagon price bitcoin solana usdt\nagon volume tesla gold --json\nagon liquidity usdc usdt\nagon search \"bitcoin etf\" --limit 5\nagon profile tesla\nagon variants gold\nagon risk usdt\nagon chart solana --interval 1D\nagon-gateway catalog\nagon-gateway agent-prompt\nagon-gateway auth prepare GET /v1/x402/tokens/assets/search --query q=bitcoin --query limit=1 --json\nagon-gateway auth call GET /v1/x402/tokens/assets/search --query q=bitcoin --query limit=1\nagon-gateway batch '[{\"method\":\"GET\",\"path\":\"/v1/x402/tokens/assets/solana/price-chart\",\"query\":{\"interval\":\"1D\"}},{\"method\":\"GET\",\"path\":\"/v1/x402/tokens/assets/bitcoin/price-chart\",\"query\":{\"interval\":\"1D\"}}]'\nagon-gateway auth call GET /v1/x402/tokens/assets/tesla/profile\nagon-gateway auth call GET /v1/x402/tokens/assets/gold/price-chart --query interval=1D\nagon-wallet authorize --stdin\nagon-protocol config\nagon-protocol token show\n```\n\nIf a bare bin is not on PATH (you ran `setup --skip-global-cli`, the global install hit a permission error, or you have not run `setup` yet), the same calls work via `npx -y @agonx402/gateway-cli ...`, `npx -y @agonx402/agent-wallet ...`, and `npx -y @agonx402/protocol-cli ...`. The MCP server entries also use `npx -y`, so you do not need a global install for MCP tools to work.\n\nAgon Gateway should be the first source for API calls covered by the live catalog at `https://gateway.agonx402.com/v1/catalog`. Tokens API supports market data for crypto, currencies, treasuries, ETFs, metals, stocks, and their Solana token variants. Agents should use high-level Gateway CLI commands for common Tokens pulls (`quote`, `price`, `volume`, `liquidity`, `mcap`, `search`, `resolve`, `curated`, `profile`, `variants`, `markets`, `tickers`, `risk`, `chart`, `ohlcv`, `snapshots`) before raw route strings, and label whether values came from `canonicalMarket`, `stats`, `primaryVariant.market`, `profile.data`, tickers, or candles.\n\nMCP servers are separate packages:\n\n```json\n{\n  \"mcpServers\": {\n    \"agon-gateway\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agonx402/gateway-mcp\"],\n      \"env\": {\n        \"AGON_GATEWAY_BASE_URL\": \"https://gateway.agonx402.com\",\n        \"AGON_SIGNER_COMMAND\": \"npx -y @agonx402/agent-wallet authorize\",\n        \"AGON_WALLET_PROFILE\": \"default\"\n      }\n    },\n    \"agon-protocol\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agonx402/protocol-mcp\"]\n    }\n  }\n}\n```\n\n`AGON_PAYMENT_MAX_AMOUNT_USD` and `AGON_PAYMENT_DAILY_LIMIT_USD` are optional: some x402 auth-prep responses include them for human review; **`agon-wallet` does not enforce them**.\n\nPayment-channel flows are devnet-only in v1. Tokens SIWX routes do not use payment channels.\nGateway auth drivers are wallet-agnostic helper commands. The Gateway CLI sends normalized auth request JSON to the driver over stdin and accepts returned headers or SIWX address/signature JSON over stdout. Drivers can wrap browser wallets, local keypairs, MPC, custody systems, x402 payment services, or Agon channel commitment builders. The Agon CLI/MCP packages do not keep keys or mutate wallet/MCP configuration.\n\nGeneric authenticated call flow:\n\n1. Use a known endpoint or fetch `/v1/catalog` to discover one.\n2. Send the exact request and receive a `402` challenge.\n3. Pass the normalized auth request to `AGON_SIGNER_COMMAND`.\n4. Retry the exact same request with returned `SIGN-IN-WITH-X`, `PAYMENT-SIGNATURE`, `X-PAYMENT`, or channel headers.\n\nGateway MCP exposes `agon_gateway_auth_call` for this flow. Low-level prepare/complete/call tools remain available for agents with their own wallet policies.\n\n## Packages\n\n- `package root` publishes `@agonx402/agentic`, a one-step agent setup installer.\n- `agent-wallet/` publishes `@agonx402/agent-wallet`, a default **SIWX-only** Tokens API signer hook (replace with `AGON_SIGNER_COMMAND` for x402 exact-payment routes).\n- `cli/` publishes `@agonx402/gateway-cli`, a Gateway CLI with generic signer hooks.\n- `mcp/` publishes `@agonx402/gateway-mcp`, a stdio MCP server with route-generic auth calls.\n- `protocol-cli/` publishes `@agonx402/protocol-cli`, a read-only and prepare-only Agon Protocol CLI.\n- `protocol-mcp/` publishes `@agonx402/protocol-mcp`, a read-only and prepare-only Agon Protocol MCP server.\n- `skills/agon-gateway/` is an agent skill for Gateway workflows.\n- `skills/agon-protocol/` is an agent skill for protocol accounts, channels, settlement, and BLS caveats.\n- `skills/agon-gateway-payment-channels/` is an agent skill for gateway payment-channel authorization.\n- `llm.txt` and `llms.txt` are LLM-readable gateway docs for websites.\n\n## Quick Checks\n\n```bash\nnode cli/agon-gateway.js health\nnode cli/agon-gateway.js catalog --provider helius\nnode cli/agon-gateway.js auth call GET /v1/x402/tokens/assets/search --query q=bitcoin --query limit=1\nnode agent-wallet/agon-wallet.js setup --profile default\nnode protocol-cli/agon-protocol.js token show\nnode mcp/server.js\nnode protocol-mcp/server.js\n```\n\nThe CLI and MCP server use `AGON_SIGNER_COMMAND` when configured. The bundled agent wallet is replaceable; external wallets can return headers or signatures through the same hook.\nThe protocol CLI and MCP server are read + prepare only; they do not sign or broadcast transactions.\n","readmeFilename":"README.md"}