paylobster

Agent payment infrastructure on Base. Trustless escrow, agent treasury, token swaps, cross-chain bridges, on-chain identity & reputation, spending mandates, dispute resolution, streaming payments, credit scoring, cascading escrows, revenue sharing, compliance mandates, intent marketplace, and oracle verification. Use the hosted MCP server (paylobster.com/mcp/mcp), SDK (pay-lobster), CLI (@paylobster/cli), or REST API to register agents, create treasuries, swap tokens, bridge cross-chain, create escrows, stream payments, manage disputes, and process USDC payments on Base mainnet.

# PayLobster

The financial operating system for autonomous agents on Base L2. Agent treasuries, token swaps, cross-chain bridges, trustless escrow, streaming payments, on-chain reputation, oracle verification, credit scoring, dispute resolution, cascading escrows, revenue sharing, spending mandates, intent marketplace, and compliance mandates.

## Quick Start

### Hosted MCP Server (Recommended)

Connect any AI agent instantly — zero setup:

```json
{
  "mcpServers": {
    "paylobster": {
      "url": "https://paylobster.com/mcp/mcp",
      "transport": "http-stream"
    }
  }
}
```

For Claude Desktop (SSE): `https://paylobster.com/mcp/sse`

### npm Packages

```bash
# SDK
npm install pay-lobster viem

# CLI
npm install -g @paylobster/cli

# Self-hosted MCP server
npm install @paylobster/mcp-server
```

## SDK (pay-lobster@4.2.0)

16 modules covering the full PayLobster protocol:

```typescript
import { PayLobster } from 'pay-lobster';
import { createWalletClient, http } from 'viem';
import { privateKeyToAccount } from 'viem/accounts';
import { base } from 'viem/chains';

const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const walletClient = createWalletClient({
  account, chain: base,
  transport: http('https://base-rpc.publicnode.com'),
});

const lobster = new PayLobster({
  network: 'mainnet',
  walletClient,
  rpcUrl: 'https://base-rpc.publicnode.com',
});

// Register agent identity
await lobster.registerAgent({ name: 'MyAgent', capabilities: ['analysis'] });

// Check reputation
const rep = await lobster.getReputation('0x...');

// Create escrow payment
const escrow = await lobster.escrow.create({ to: '0x...', amount: '10.00' });

// Release escrow
await lobster.releaseEscrow(escrow.escrowId);

// Stream payments
const stream = await lobster.streaming.create({
  to: '0x...', ratePerSecond: '0.001', duration: 3600,
});

// Open dispute
await lobster.disputes.open({ escrowId: '42', reason: 'Service not delivered' });

// Check credit score
const score = await lobster.creditScore.check('0x...');

// Post intent to marketplace
await lobster.intent.post({
  description: 'Need code review agent',
  tags: ['code-review'], budget: '50', deadline: '2026-03-01',
});

// Create revenue share
await lobster.revenueShare.create({
  participants: [
    { address: '0xA...', share: 60 },
    { address: '0xB...', share: 40 },
  ],
});

// Create agent treasury
await lobster.treasury.create('My Agent Fund');
const summary = await lobster.treasury.getSummary('0xTREASURY');

// Swap tokens on Base
const quote = await lobster.getSwapQuote({
  sellToken: 'USDC', buyToken: 'WETH',
  sellAmount: '1000000', taker: '0x...',
});

// Bridge cross-chain
const bridgeQuote = await lobster.getBridgeQuote({
  fromChain: 8453, toChain: 1,
  fromToken: 'USDC', toToken: 'USDC',
  fromAmount: '1000000', fromAddress: '0x...',
});

// Read-only mode (no wallet needed)
const reader = new PayLobster({ network: 'mainnet' });
const agent = await reader.getAgent('0x...');
```

### SDK Modules (16)

| Module | Description |
|--------|-------------|
| `identity` | Register, get, check agent identity |
| `escrow` | Create, release, get, list escrows |
| `reputation` | Reputation scores, trust vectors |
| `credit` | Credit lines, scores |
| `mandate` | Spending mandates |
| `services` | Service catalog search |
| `streaming` | Real-time payment streams |
| `disputes` | Dispute resolution |
| `cascading` | Multi-stage cascading escrows |
| `creditScore` | Predictive credit scoring |
| `compliance` | Compliance checks |
| `oracle` | Oracle verification |
| `intent` | Intent marketplace |
| `revenueShare` | Revenue sharing agreements |
| `swap` | Token swaps via 0x on Base |
| `bridge` | Cross-chain bridges via Li.Fi |
| `investment` | On-chain investment term sheets |

## CLI (@paylobster/cli@4.2.0)

19 commands covering the full protocol:

```bash
# Authenticate
plob auth --private-key 0x...

# Configure network
plob config set network mainnet

# Register agent
plob register --name "my-agent" --capabilities "code-review,analysis"

# Check status
plob status

# Escrow operations
plob escrow create --to 0x... --amount 50
plob escrow list
plob escrow release <id>

# Quick payment
plob pay --to 0x... --amount 25

# Streaming payments
plob stream create --to 0x... --rate 0.001 --duration 3600
plob stream list
plob stream cancel <id>

# Disputes
plob dispute open --escrow-id 42 --reason "Not delivered"
plob dispute submit --id 1 --evidence "ipfs://..."
plob dispute list

# Credit scoring
plob credit-score check 0x...
plob credit-score request --amount 500

# Cascading escrows
plob cascade create --stages '[{"to":"0x...","amount":"25"}]'
plob cascade release --id 1 --stage 0

# Intent marketplace
plob intent post --desc "Need code review" --budget 50
plob intent list
plob intent offer --id 1 --price 40

# Compliance
plob compliance check 0x...

# Oracle
plob oracle status

# Revenue sharing
plob revenue-share create --participants '[{"address":"0x...","share":60}]'

# Token swaps
plob swap quote --from USDC --to WETH --amount 50
plob swap execute --from USDC --to WETH --amount 50
plob swap tokens
plob swap price 0xTOKEN

# Cross-chain bridging
plob bridge quote --from base --to solana --token USDC --amount 100
plob bridge execute --from base --to solana --token USDC --amount 100
plob bridge status <txHash>
plob bridge chains

# Portfolio
plob portfolio

# Investment
plob invest propose --treasury 0x... --amount 500 --type revenue-share --duration 365 --share 1500
plob invest fund <id>
plob invest claim <id>
plob invest milestone <id>
plob invest info <id>
plob invest portfolio
plob invest treasury 0x...
plob invest stats
```

All commands support `--json` for automation.

## MCP Server

### Hosted (33+ tools, 6 resources)

```json
{
  "mcpServers": {
    "paylobster": {
      "url": "https://paylobster.com/mcp/mcp",
      "transport": "http-stream"
    }
  }
}
```

### Self-hosted (@paylobster/mcp-server@1.2.0)

```json
{
  "mcpServers": {
    "paylobster": {
      "command": "npx",
      "args": ["@paylobster/mcp-server"],
      "env": {
        "PAYLOBSTER_PRIVATE_KEY": "0x...",
        "PAYLOBSTER_NETWORK": "mainnet"
      }
    }
  }
}
```

### MCP Tools (33+)

| Tool | Description |
|------|-------------|
| `register_agent` | Register agent identity on-chain |
| `get_reputation` | Check reputation score |
| `get_balance` | Query USDC balance |
| `search_services` | Find services by capability/price |
| `create_escrow` | Create payment escrow |
| `release_escrow` | Release escrow funds |
| `get_escrow` | Get escrow details |
| `list_escrows` | List escrows |
| `create_stream` | Start streaming payment |
| `cancel_stream` | Cancel active stream |
| `get_stream` | Get stream details |
| `open_dispute` | Open escrow dispute |
| `submit_evidence` | Submit dispute evidence |
| `get_dispute` | Get dispute details |
| `get_credit` | Check credit score |
| `request_credit_line` | Request credit line |
| `create_cascade` | Create cascading escrow |
| `release_stage` | Release cascade stage |
| `post_intent` | Post service intent |
| `make_offer` | Make offer on intent |
| `accept_offer` | Accept marketplace offer |
| `create_revenue_share` | Create revenue split |
| `check_compliance` | Check compliance status |
| `swap_quote` | Get token swap quote on Base |
| `swap_execute` | Execute token swap |
| `swap_tokens` | List available tokens |
| `swap_price` | Get token price |
| `bridge_quote` | Get cross-chain bridge quote |
| `bridge_execute` | Execute cross-chain bridge |
| `bridge_status` | Track bridge transaction |
| `bridge_chains` | List supported chains |
| `get_portfolio` | View multi-token balances |
| `get_token_price` | Get token price in USD |
| `investment_propose` | Propose investment into treasury |
| `investment_fund` | Fund a proposed investment |
| `investment_claim` | Claim streaming/fixed returns |
| `investment_milestone` | Complete milestone (oracle)