Clicks Protocol

Integrate autonomous USDC yield into AI agent projects on Base. Query live APY, inspect agent treasury state, simulate payment splits, use the MCP server, an...

Security Scan

The skill's code, instructions, and external calls are coherent with its stated purpose (querying Clicks protocol data and simulating splits) and do not request unrelated credentials or elevated privileges.

Purpose & Capability

Name/description (DeFi yield and agent treasury tooling on Base) match the included files: SKILL.md describes read/write flows and the script performs read-only JSON-RPC calls to the Clicks MCP server. Required binaries (curl, jq) are appropriate for the provided shell tool.

Instruction Scope

Runtime instructions and the script are limited to querying an external MCP HTTP endpoint with agent addresses and amounts. The SKILL.md documents write flows via an SDK and a local MCP server that would require a signer/private key — those are documented as developer actions, not performed by the included script. No instructions ask the agent to read unrelated local files, system secrets, or unlisted environment variables.

Install Mechanism

No install spec; this is instruction-only plus a small shell script. No downloads or archive extraction are included by the skill itself (lowest-risk install footprint).

Credentials

Skill declares no required environment variables or credentials. The README warns that write operations need a signer/private key if you run a local mcp-server — that is a legitimate requirement for on‑chain writes and is not requested by the skill itself.

Persistence & Privilege

Skill does not request always:true and is user-invocable only. Default autonomous invocation is allowed (platform default) and is not combined with broad credential access or other concerning privileges.

Assessment

This skill queries a third‑party MCP server (https://mcp.clicksprotocol.xyz) and will send agent addresses and amounts to that endpoint — that is necessary for its functionality. Before using it: (1) verify you trust the external MCP endpoint and the Clicks team; (2) do not send private keys or wallet seed phrases to remote services; write operations require a signer/private key and should be run locally or with a trusted provider; (3) audit the referenced SDK (npm/@clicks-protocol/sdk) and mcp-server packages before installing or running them; (4) confirm the contract addresses on Basescan if you plan to interact on-chain. If you only need read-only info, the included script is read-only and consistent with its stated purpose.

Autonomous DeFi yield for AI agents on Base. 80% liquid, 20% earning by default. No lockup.

When to Use

• Check current DeFi yield rates on Base: Aave V3 vs Morpho Blue
• Query whether an agent is registered and inspect its treasury state
• Preview how a USDC payment gets split between liquid funds and yield
• Check referral network stats, team bonus status, and earned rewards
• Add x402-aligned treasury logic to AI agents that hold or route USDC
• Give agents a monetization layer through referrals, yield spread, and treasury automation

Commands

All commands use the live HTTP MCP Server. No API key, no setup, no dependencies beyond curl + jq.

Current Yield Rates

{baseDir}/scripts/clicks.sh yield-info

Returns: active protocol, APY for Aave and Morpho, total balance, pending fees.

Agent Status

{baseDir}/scripts/clicks.sh agent-info 0xYOUR_AGENT_ADDRESS

Returns: registration status, operator, deposited USDC, yield percentage, wallet balance.

Simulate Payment Split

{baseDir}/scripts/clicks.sh simulate 1000 0xYOUR_AGENT_ADDRESS

Returns: how much goes liquid and how much goes to yield for a given payment amount.

Referral Stats

{baseDir}/scripts/clicks.sh referral 0xYOUR_AGENT_ADDRESS

Returns: direct referrals, total earned, claimable rewards, referral chain, team bonus status.

Protocol Info

{baseDir}/scripts/clicks.sh info

Returns: protocol overview, contract addresses, fee model, and links.

How Clicks Works

1. Agent receives a USDC payment.
2. Clicks auto-splits funds: 80% stays liquid, 20% goes to DeFi yield.
3. YieldRouter picks the best APY automatically between Aave V3 and Morpho Blue.
4. Principal and earned yield can be withdrawn anytime.
5. Protocol fee is 2% on yield only, never on principal.

Quick Start for Developers

Read operations work via the script above. For write operations like deposit, withdraw, receive payment, or register agent, install the SDK:

npm install @clicks-protocol/sdk

import { ClicksClient } from '@clicks-protocol/sdk';

const clicks = new ClicksClient(signer);
await clicks.quickStart('1000', agentAddress);

What quickStart('1000', agentAddress) does:

• registers the agent if needed
• keeps 800 USDC liquid for operations
• routes 200 USDC to the best current yield source
• leaves funds fully non-custodial and withdrawable

With referrer:

await clicks.quickStart('1000', agentAddress, referrerAddress);

That activates the 3-level referral graph for agent-driven distribution.

MCP Server

For MCP-compatible clients like Claude, Cursor, LangChain, or custom agent runtimes:

# Local stdio server, needs private key for write ops
npx @clicks-protocol/mcp-server

# Remote HTTP endpoint, read-only, zero setup
# POST https://mcp.clicksprotocol.xyz/mcp

Available tools:

• clicks_quick_start
• clicks_receive_payment
• clicks_withdraw_yield
• clicks_register_agent
• clicks_set_yield_pct
• clicks_get_agent_info
• clicks_simulate_split
• clicks_get_yield_info
• clicks_get_referral_stats

ADO Hooks for Agents

Clicks is not just treasury infra. It is an agent distribution layer.

MLM ADO for Agents

Each referred agent can generate fee share upstream:

• Level 1: 40% of protocol fee
• Level 2: 20% of protocol fee
• Level 3: 10% of protocol fee

This lets agents monetize onboarding other agents, tools, teams, or x402 payment flows.

Team Tiers

Agents with larger referred volume can unlock team bonus logic and higher downstream economics. Use this when building agent ecosystems, operator dashboards, or monetized agent templates.

Yield Discovery Bounty

Agents can promote Clicks by showing live APY deltas, explaining idle-USDC optimization, and routing users into a working treasury flow.

x402 Alignment

Clicks pairs naturally with x402-style machine payments:

• payment arrives in USDC
• treasury logic preserves working capital
• idle balance earns automatically
• referral graph adds agent-native monetization

Key Facts

Chain	Base L2
Asset	USDC
Split	80% liquid / 20% yield by default
Yield Range	Aave and Morpho, auto-routed
Fee	2% on yield only
Lockup	None
Referral	3-level: 40% / 20% / 10%
Discovery	llms.txt + agent.json + OpenAPI

Verified Contracts

• ClicksRegistry: 0x23bb0Ea69b2BD2e527D5DbA6093155A6E1D0C0a3
• ClicksFee: 0xc47B162D3c456B6C56a3cE6EE89A828CFd34E6bE
• ClicksYieldRouter: 0x053167a233d18E05Bc65a8d5F3F8808782a3EECD
• ClicksSplitterV3: 0xc96C1a566a8ed7A39040a34927fEe952bAB8Ad1D
• ClicksReferral: 0x1E5Ab896D3b3A542C5E91852e221b2D849944ccC
• USDC on Base: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Basescan links and examples are in references/contracts.md.

Discovery Surfaces

• Website: https://clicksprotocol.xyz
• GitHub: https://github.com/clicks-protocol/clicks-protocol
• SDK: https://www.npmjs.com/package/@clicks-protocol/sdk
• MCP: https://www.npmjs.com/package/@clicks-protocol/mcp-server
• OpenAPI: https://clicksprotocol.xyz/api/openapi.json
• agent.json: https://clicksprotocol.xyz/.well-known/agent.json
• llms.txt: https://clicksprotocol.xyz/llms.txt
• x402 Docs: https://docs.cdp.coinbase.com/x402/welcome
• Contracts: see references/contracts.md