How do I install Clicks Protocol?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Clicks Protocol need an API key?

The publisher lists these environment variables: CLICKS_PRIVATE_KEY, CLICKS_RPC_URL.

What transport does Clicks Protocol use?

Clicks Protocol runs locally over stdio.

When was Clicks Protocol last checked?

Last checked 2026-11-09. Agent commerce settlement tools on Base: treasury setup, payment splits, yield and attribution.

Clicks Protocol MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @clicks-protocol/[email protected]

Credentials from the publisher

CLICKS_PRIVATE_KEY — Private key for write operations (register, deposit, withdraw). Not needed for read-only tools.
CLICKS_RPC_URL — Base RPC URL. Defaults to https://mainnet.base.org

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1CLICKS_PRIVATE_KEY=<secret> CLICKS_RPC_URL=<value> claude mcp add io.github.clicksprotocol-mcp-server -- npx -y @clicks-protocol/mcp-server@0.3.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.clicksprotocol-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "@clicks-protocol/[email protected]"8      ],9      "env": {10        "CLICKS_PRIVATE_KEY": "<secret>",11        "CLICKS_RPC_URL": "<value>"12      }13    }14  }15}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.0.3

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

One call. Yield starts.

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

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:

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.

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

// 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)

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:

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:

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`
ClicksSplitterV4	`0xB7E0...f3C8`
ClicksYieldRouter	`0x0531...EECD`
ClicksFeeV2	`0x8C4E...0fb5`
ClicksReferral	`0x1E5A...4ccC`
Safe Multisig (Owner)	`0xaD82...D6A9`
USDC	`0x8335...913`

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 as agentId 45074. On-chain reputation accrues per completed agent job. Attestors who follow the Clicks Attestor Schema V1 become eligible for the reputation-aware fee multiplier (shipping in V5).

Manifest: /.well-known/agent-registration.json
Schema V1: 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 — full protocol docs for LLMs
agent.json: 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:

{
  "mcpServers": {
    "clicks-protocol": {
      "url": "https://mcp.clicksprotocol.xyz/mcp"
    }
  }
}

OpenClaw

openclaw mcp set clicks-protocol --url https://mcp.clicksprotocol.xyz/mcp

Codex CLI

Add to .codex/config.json:

{
  "mcpServers": {
    "clicks-protocol": {
      "type": "url",
      "url": "https://mcp.clicksprotocol.xyz/mcp"
    }
  }
}

Gemini CLI

{
  "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/ 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

npm install
npx hardhat compile
npx hardhat test          # 227 tests

License

MIT

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Clicks Protocol?

Does Clicks Protocol need an API key?

What transport does Clicks Protocol use?

When was Clicks Protocol last checked?

Documentation

One call. Yield starts.

What Clicks does

Install

x402 + Coinbase Agentic Wallets

SDK

Quick Start (recommended)

Individual operations

Read-only (no signer needed)

MCP Server

Referral Network

Agent Teams

Contracts (Base Mainnet)

ERC-8004 Trustless Agent

Architecture

Agent Discovery

Connect Your AI Agent

Claude Desktop

OpenClaw

Codex CLI

Gemini CLI

Available MCP Tools

Works with

Development

License