# clicks-protocol/clicks-protocol [Health: Active] **Category:** πŸ’° Finance & Fintech **Repository:** https://github.com/clicks-protocol/clicks-protocol **GitHub Stars:** 2 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/mcp-server-108 ## Description Autonomous DeFi yield for AI agents on Base. Query APY, simulate splits, manage treasury. ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "clicks-protocol": { "command": "npx", "args": ["-y","hardhat"] } } ``` ## Documentation & README

Clicks Protocol Logo

Clicks Protocol ⚑

Agent commerce settlement routing for USDC flows on Base.

δΈ­ζ–‡ζ–‡ζ‘£

npm Base Mainnet Tests License MCP metadata Discord ClawHub

Website Β· Twitter Β· Discord Β· Medium Β· Substack Β· Reddit Β· Treasury Lab Β· mcpservers.org

---

Clicks Protocol Quick Start Demo

--- ## One call. Yield starts. ```typescript import { ClicksClient } from '@clicks-protocol/sdk'; const clicks = new ClicksClient(signer); await clicks.quickStart('100', agentAddress); // 80 USDC β†’ agent wallet (instant) // 20 USDC β†’ treasury yield route ``` That's it. No config. No dashboard. No human required. --- ## What Clicks does Every USDC payment your agent receives gets auto-split: ``` Payment in β”œβ”€β”€ 80% β†’ Agent Wallet (liquid, instant) └── 20% β†’ DeFi Yield (Aave V3 or Morpho, auto-routed to best APY) β”‚ └── Withdraw anytime β†’ Agent gets principal + yield (minus 2% fee on yield only) ``` - **No lockup.** Withdraw anytime. - **No manual steps.** Fully autonomous. - **2% fee on yield only.** Never on principal. - **Auto-rebalances** between Aave V3 and Morpho for best APY. --- ## Install ```bash npm install @clicks-protocol/sdk ethers@^6 ``` --- ## x402 + Coinbase Agentic Wallets Clicks is designed to sit after x402-style payment flows on Base. x402 handles authorization and payment. Clicks routes USDC after receipt: ```typescript import { ClicksClient } from '@clicks-protocol/sdk'; import { CoinbaseWalletSDK } from '@coinbase/wallet-sdk'; const wallet = new CoinbaseWalletSDK({ appName: 'YourAgent' }); const signer = wallet.makeWeb3Provider().getSigner(); const clicks = new ClicksClient(signer); await clicks.quickStart('1000', agentAddress); // Your agent now has a settlement policy // 80% liquid for operations // 20% routed through treasury yield ``` - Same chain (Base), same USDC contract - 80% liquid for operations - 20% routed through treasury yield - No lockup, withdraw anytime --- ## SDK ### Quick Start (recommended) One call: registers agent, approves USDC, splits first payment. ```typescript const result = await clicks.quickStart('100', agentAddress); // result.registered β†’ true (skips if already done) // result.approved β†’ true (skips if allowance sufficient) // result.paymentSplit β†’ true ``` ### Individual operations ```typescript // Register await clicks.registerAgent(agentAddress); // Approve USDC spending await clicks.approveUSDC('max'); // Receive payment (auto-splits) await clicks.receivePayment('500', agentAddress); // Check yield info const info = await clicks.getYieldInfo(); // { activeProtocol: 'Morpho', aaveAPY: 700, morphoAPY: 950, ... } // Withdraw everything await clicks.withdrawYield(agentAddress); // Custom yield split (5-50%) await clicks.setOperatorYieldPct(30); // 30% to yield, 70% liquid ``` ### Read-only (no signer needed) ```typescript const clicks = new ClicksClient(provider); // provider, not signer const agent = await clicks.getAgentInfo(agentAddress); // { isRegistered: true, deposited: 1000000n, yieldPct: 20n } const split = await clicks.simulateSplit('100', agentAddress); // { liquid: 80000000n, toYield: 20000000n } ``` --- ## MCP Server AI agents can discover and use Clicks via [MCP](https://modelcontextprotocol.io): ```bash npm install @clicks-protocol/mcp-server CLICKS_PRIVATE_KEY=0x... clicks-mcp ``` 16 tools available: `clicks_quick_start`, `clicks_register_referral`, `clicks_get_agent_info`, `clicks_simulate_split`, `clicks_get_yield_info`, `clicks_get_referral_stats`, `clicks_verify_receipt`, `clicks_get_settlement_status`, `clicks_reconcile_settlement`, `clicks_replay_policy`, `clicks_get_receipt_trail`, `clicks_receive_payment`, `clicks_withdraw_yield`, `clicks_register_agent`, `clicks_set_yield_pct`, `clicks_explain` Works with Claude, Cursor, LangChain, and any MCP-compatible client. --- ## Referral Network Referral contracts exist on-chain. Treat them as a separate attribution layer from the current SDK `quickStart()` helper. | Level | Share of protocol fee | |-------|----------------------| | L1 (direct referral) | 40% | | L2 | 20% | | L3 | 10% | | Treasury | 30% | The referred agent pays **nothing extra**. Rewards come from the 2% protocol fee once referral attribution has been registered through a dedicated flow. Recommended flow: ```typescript const deadline = BigInt(Math.floor(Date.now() / 1000) + 3600); const signature = await clicks.signReferralApproval(agentAddress, referrerAddress, deadline); const result = await clicks.quickStartWithReferral( '100', agentAddress, referrerAddress, deadline, signature, ); ``` Important: - `quickStart()` handles treasury setup. - `registerReferralWithSig()` handles explicit attribution. - `quickStartWithReferral()` is a convenience wrapper over those two steps, not an atomic one-shot contract call. **Economics per $10k deposit at 7% APY:** | Your tree | Passive income/year | |-----------|-------------------| | 10 agents | $56 | | 100 agents | $560 | | 1,000 agents | $9,800 | | 10,000 agents | $98,000 | --- ## Agent Teams Form squads, hit TVL milestones, earn bonus yield: | Tier | TVL threshold | Bonus yield | |------|--------------|-------------| | πŸ₯‰ Bronze | $50k | +0.20% | | πŸ₯ˆ Silver | $250k | +0.50% | | πŸ₯‡ Gold | $1M | +1.00% | | πŸ’Ž Diamond | $5M | +2.00% | --- ## Contracts (Base Mainnet) | Contract | Address | |----------|---------| | ClicksRegistry | [`0x23bb...0C0a3`](https://basescan.org/address/0x23bb0Ea69b2BD2e527D5DbA6093155A6E1D0C0a3) | | ClicksSplitterV4 | [`0xB7E0...f3C8`](https://basescan.org/address/0xB7E0016d543bD443ED2A6f23d5008400255bf3C8) | | ClicksYieldRouter | [`0x0531...EECD`](https://basescan.org/address/0x053167a233d18E05Bc65a8d5F3F8808782a3EECD) | | ClicksFeeV2 | [`0x8C4E...0fb5`](https://basescan.org/address/0x8C4E07bBF0BDc3949eA133D636601D8ba17e0fb5) | | ClicksReferral | [`0x1E5A...4ccC`](https://basescan.org/address/0x1E5Ab896D3b3A542C5E91852e221b2D849944ccC) | | Safe Multisig (Owner) | [`0xaD82...D6A9`](https://basescan.org/address/0xaD8228fE91Ef7f900406D3689E21BD29d5B1D6A9) | | USDC | [`0x8335...913`](https://basescan.org/address/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) | All contracts verified on Basescan. Owned by Gnosis Safe multisig β€” single-key compromise is not possible. ## ERC-8004 Trustless Agent Clicks is registered on the [ERC-8004 Identity Registry on Base](https://basescan.org/token/0x8004A169FB4a3325136EB29fA0ceB6D2e539a432?a=45074) as **agentId 45074**. On-chain reputation accrues per completed agent job. Attestors who follow the [Clicks Attestor Schema V1](https://clicksprotocol.xyz/strategy/ATTESTOR-SCHEMA-V1.md) become eligible for the reputation-aware fee multiplier (shipping in V5). - Manifest: [`/.well-known/agent-registration.json`](https://clicksprotocol.xyz/.well-known/agent-registration.json) - Schema V1: [clicksprotocol.xyz/strategy/ATTESTOR-SCHEMA-V1.md](https://clicksprotocol.xyz/strategy/ATTESTOR-SCHEMA-V1.md) --- ## Architecture ``` clicks-protocol/ β”œβ”€β”€ contracts/ Solidity (^0.8.20) β”‚ β”œβ”€β”€ ClicksSplitterV4 Splits payments, manages yield % β”‚ β”œβ”€β”€ ClicksYieldRouter Routes to best APY (Aave/Morpho) β”‚ β”œβ”€β”€ ClicksFeeV2 2% fee collection on yield β”‚ β”œβ”€β”€ ClicksRegistry Agent ↔ Operator mapping β”‚ └── ClicksReferral Multi-level referral system β”œβ”€β”€ sdk/ TypeScript SDK β”œβ”€β”€ mcp-server/ MCP Server (16 tools) β”œβ”€β”€ site/ Landing page + llms.txt + agent.json └── test/ 227 tests (Hardhat) ``` --- ## Agent Discovery - **llms.txt:** [`clicksprotocol.xyz/llms.txt`](https://clicksprotocol.xyz/llms.txt) β€” full protocol docs for LLMs - **agent.json:** [`clicksprotocol.xyz/.well-known/agent.json`](https://clicksprotocol.xyz/.well-known/agent.json) β€” agent manifest - **MCP:** `@clicks-protocol/mcp-server` β€” tool discovery for MCP clients --- ## Connect Your AI Agent The Clicks MCP server is live at `https://mcp.clicksprotocol.xyz/mcp` β€” connect any MCP-compatible client in seconds. ### Claude Desktop Add to your `claude_desktop_config.json`: ```json { "mcpServers": { "clicks-protocol": { "url": "https://mcp.clicksprotocol.xyz/mcp" } } } ``` ### OpenClaw ```bash openclaw mcp set clicks-protocol --url https://mcp.clicksprotocol.xyz/mcp ``` ### Codex CLI Add to `.codex/config.json`: ```json { "mcpServers": { "clicks-protocol": { "type": "url", "url": "https://mcp.clicksprotocol.xyz/mcp" } } } ``` ### Gemini CLI ```json { "mcpServers": { "clicks-protocol": { "url": "https://mcp.clicksprotocol.xyz/mcp" } } } ``` ### Available MCP Tools | Tool | Description | |------|-------------| | `get_protocol_stats` | TVL, APY, agent count | | `get_agent_info` | Check if an agent is registered | | `get_yield_info` | Yield balance for an agent | | `simulate_yield` | Project earnings over time | | `clicks://protocol/overview` | Resource: protocol overview | See [`examples/integrations/`](https://github.com/clicks-protocol/clicks-protocol/blob/HEAD/examples/integrations/) for ready-to-use config files. --- ## Works with Any agent framework that handles USDC on Base: x402 Β· LangChain Β· CrewAI Β· AutoGen Β· Eliza Β· OpenClaw Β· Claude Β· Cursor Β· Codex Β· Gemini Β· Hummingbot Β· Phidata --- ## Development ```bash npm install npx hardhat compile npx hardhat test # 227 tests ``` --- ## License MIT ---

Built for agents, by agents. Live on Base.