b0ase avatar

Path402 — Tokenised Web Content for AI Agents

b0ase/path402

Gives Claude the ability to buy, sell, and serve tokenized web content through the $402 protocol on BSV. The agent can discover tokenized paths, evaluate ROI using bonding curve economics, acquire tokens within budget constraints, and earn revenue by serving content to other agents. Each tool maps to a specific economic action: path402_discover probes pricing and supply, path402_evaluate runs breakeven analysis, path402_acquire makes purchases, path402_serve delivers content for payment. Also includes x402 cross-chain verification tools and a companion path402d daemon for running your own network node with PoW20 mining. Useful when you want your agent to operate as an autonomous economic actor that can assess, acquire, and monetize access to gated resources.

GitHub stars
1
tools
16
auth
Secret needed
transport
STDIO
env vars
3
last updated
Apr 1, 2026

Tools

16 tools

Public tool metadata for what this MCP can expose to an agent.

path402_discoverProbe a $address for pricing, supply, revenue model, and nested paths

Probe a $address for pricing, supply, revenue model, and nested paths

No parameter schema in public metadata yet.

path402_batch_discoverDiscover multiple $addresses in a single call

Discover multiple $addresses in a single call

No parameter schema in public metadata yet.

path402_evaluateAssess ROI viability before purchasing

Assess ROI viability before purchasing

No parameter schema in public metadata yet.

path402_economicsDeep financial analysis: breakeven, projections, scenarios

Deep financial analysis: breakeven, projections, scenarios

No parameter schema in public metadata yet.

path402_price_scheduleView how price changes across supply levels

View how price changes across supply levels

No parameter schema in public metadata yet.

path402_acquirePurchase tokens and receive gated content

Purchase tokens and receive gated content

No parameter schema in public metadata yet.

path402_set_budgetConfigure agent spending parameters

Configure agent spending parameters

No parameter schema in public metadata yet.

path402_walletView balance, holdings, and net financial position

View balance, holdings, and net financial position

No parameter schema in public metadata yet.

path402_transferTransfer tokens to another address

Transfer tokens to another address

No parameter schema in public metadata yet.

path402_historyView transaction history

View transaction history

No parameter schema in public metadata yet.

path402_serveDistribute content and earn revenue

Distribute content and earn revenue

No parameter schema in public metadata yet.

path402_servableList all content the agent can serve

List all content the agent can serve

No parameter schema in public metadata yet.

path402_registerRegister a new $address as issuer

Register a new $address as issuer

No parameter schema in public metadata yet.

x402_verifyVerify payment proof from any supported chain

Verify payment proof from any supported chain

No parameter schema in public metadata yet.

x402_settleSettle cross-chain payment via facilitator

Settle cross-chain payment via facilitator

No parameter schema in public metadata yet.

x402_inscriptionGet or create BSV inscription proof

Get or create BSV inscription proof

No parameter schema in public metadata yet.

Sponsors

Configuration

PATH402_API_URL

Base URL of the Path402 API server (default: https://path402.com)

PATH402_DEFAULT_BUDGET

Default spending budget in satoshis for token acquisitions

PATH402_WALLET_WIFsecret

BSV wallet private key (WIF format) for on-chain acquisitions

Readme

path402

Turn AI agents into autonomous economic actors. Run a $402 network node.

This package includes:

  • MCP Server — AI agent tools for Claude, GPT, etc.
  • path402d Daemon — Index tokens, serve content, earn rewards

npm version License: Open BSV


Quick Start

Installation

npm install -g path402

Run path402d 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 $402 rewards via PoW20

path402d CLI Commands

path402d start           # Start the daemon
path402d status          # Check if running
path402d stop            # Stop the daemon
path402d config          # Show configuration
path402d mine            # Start PoW20 mining (experimental)
path402d --help          # Full help

Why Run path402d?


View the full README on GitHub

Details

Repository
github.com/b0ase/path402
Package
path402
Transport
STDIO
Auth
Required
Registry
MCP registry, active