path402

path402

The $402 Protocol — Tokenized Attention Economy

MCP server, network daemon, and token minting for tokenized attention markets.

What's Included

Component	Command	Description
MCP Server	path402	AI agent tools for Claude, GPT, etc.
Network Daemon	path402d	Index tokens, serve content, earn rewards
Client CLI	path402-client	Interact with the $402 network

Quick Start

Installation

npm install -g path402

Run the Daemon

path402d start

This starts a $402 network node that:

• INDEX — Reads BSV blockchain, tracks all $402 tokens
• VALIDATE — Confirms token ownership before serving
• SERVE — Delivers content to verified token holders
• EARN — Receives rewards via Proof of Serve

CLI Commands

path402d start           # Start the daemon
path402d status          # Check if running
path402d stop            # Stop the daemon
path402d config          # Show configuration
path402d --help          # Full help

MCP Server (for AI Agents)

npx path402

Claude Desktop Integration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "path402": {
      "command": "npx",
      "args": ["path402"],
      "env": {
        "PATH402_API_URL": "https://path402.com",
        "PATH402_DEFAULT_BUDGET": "10000"
      }
    }
  }
}

The $402 Protocol

Two Models of Tokenization

1. Content Tokenization — Turn URL paths into shareholder businesses

$example.com              → Site-level token
$example.com/$api         → API access token
$example.com/$blog        → Blog content token

2. Personal Tokenization — Mint your own attention token

$RICHARD                  → Richard's attention token
$ALICE                    → Alice's attention token
$SPIELBERG                → Spielberg's attention token

Personal Tokens: The Attention Economy

Every person can mint their own token:

Property	Value
Supply	1,000,000,000 (fixed)
Access Rate	1 token = 1 second
Burning	Disabled (tokens circulate)
Float	Creator-controlled

How it works:

You hold 3600 $RICHARD tokens
    ↓
You can open a 1-hour connection with Richard
    ↓
After the call, you STILL hold 3600 tokens
    ↓
Tokens are reusable passes, not consumables

Social Scaling

The network grows through genuine relationships:

I value my friend
       ↓
I buy MORE tokens than I need
       ↓
I stake tokens (earn from their success)
       ↓
They succeed → I profit + maintain access

Staking & Dividends

Amount-based dividend model:

your_dividend = (your_staked / total_staked) × period_revenue

Revenue Split (Default):
├── 70% → Creator wallet
├── 20% → Staker dividend pool
└── 10% → Protocol treasury

KYC required for dividends — Basic token holding is permissionless. Dividend claims require identity verification.

Proof of Serve (Not Proof of Work)

Nodes earn through actual contribution:

Action	Description
SERVE	Deliver content to requesters
RELAY	Forward gossip messages
INDEX	Maintain accurate token indexes
VALIDATE	Verify transactions

node_reward = (node_serves / total_network_serves) × daily_pool

Why Proof of Serve?

• Rewards useful work, not hash computation
• No energy waste
• No ASIC centralization
• Everyone who serves earns

sqrt_decay Pricing

Price is determined by remaining treasury:

price = base_price / √(treasury_remaining + 1)

Treasury	Price	% Sold
500M	10 sats	0%
100M	22 sats	80%
10M	71 sats	98%
1M	224 sats	99.8%

Key insight: Early buyers always get better prices.

MCP Tool Reference

Discovery Tools

Tool	Description
path402_discover	Probe a $address for pricing and terms
path402_batch_discover	Discover multiple $addresses
path402_evaluate	Assess ROI before purchasing
path402_economics	Deep financial analysis
path402_price_schedule	View price curve

Acquisition Tools

Tool	Description
path402_acquire	Purchase tokens
path402_set_budget	Configure spending limits
path402_wallet	View holdings
path402_transfer	Transfer tokens

Serving Tools

Tool	Description
path402_serve	Serve content, earn revenue
path402_servable	List servable content

Database Tools

Tool	Description
path402_token_stats	Live token statistics
path402_holders	List token holders
path402_verify	Verify token ownership

Token Minting (BSV21)

Mint personal tokens using the BSV21 standard:

import { prepareMint, validateSymbol } from 'path402';

// Validate symbol
const validation = validateSymbol('$RICHARD');
if (!validation.valid) throw new Error(validation.error);

// Prepare mint
const result = prepareMint({
  symbol: '$RICHARD',
  issuerAddress: '1ABC...',
  description: 'Access token for Richard',
  accessRate: 1  // 1 token per second
});

console.log(result.inscription);  // BSV21 inscription JSON
console.log(result.tokenId);      // Deterministic token ID

Inscription Format

{
  "p": "bsv-21",
  "op": "deploy",
  "tick": "$RICHARD",
  "max": "1000000000",
  "dec": "0",
  "path402": {
    "accessRate": 1,
    "protocol": "path402",
    "version": "1.0.0"
  }
}

Configuration

Environment Variables

Variable	Default	Description
PATH402_API_URL	https://path402.com	API endpoint
PATH402_DEFAULT_BUDGET	10000	Budget in sats
PATH402_WALLET_KEY	-	Wallet signing key
PATH402_AUTO_ACQUIRE	false	Auto-acquire
PATH402_LOG_LEVEL	info	Log verbosity

Use Cases

1. Self-Funding Agent

1. path402_acquire() tokens at low prices
2. path402_serve() to other agents
3. path402_wallet() to track profits
4. Reinvest profits into more tokens

2. Attention Market

1. Mint $YOURNAME token
2. Set access rate (tokens/second)
3. Sell tokens to those who want your time
4. Stake holders earn from your success

3. Content Monetization

1. Register $yourdomain.com/$content
2. Set pricing curve
3. Buyers acquire tokens for access
4. Serve content, earn revenue

Supported Networks

Network	Status	Assets
BSV	Primary	BSV, BSV-21 tokens
Base	Supported	USDC, ETH
Solana	Supported	USDC, SOL
Ethereum	Supported	USDC, ETH

BSV is the settlement layer. Cross-chain payments are verified and inscribed on BSV.

Development

git clone https://github.com/b0ase/path402-mcp-server
cd path402-mcp-server
pnpm install
pnpm run build
pnpm run dev

Version History

v1.3.0 (Current)

• ✅ Personal token minting (BSV21)
• ✅ Proof of Serve rewards
• ✅ Attention economy model
• ✅ Rebranded CLI (path402d)
• ✅ Package renamed to path402

v1.2.0

• ✅ Database tools (live stats, holders, verify)
• ✅ Electron desktop app
• ✅ GUI dashboard

v1.0.0

• ✅ 10 core MCP tools
• ✅ sqrt_decay pricing
• ✅ Budget management

Links

• Website: path402.com
• Whitepaper: path402.com/whitepaper
• Exchange: path402.com/exchange
• Docs: path402.com/docs
• GitHub: github.com/b0ase/path402-mcp-server

License

MIT

Built by b0ase.com | Powered by BSV