Package Exports

@paylobster/mcp-server
@paylobster/mcp-server/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@paylobster/mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

PayLobster MCP Server

Model Context Protocol (MCP) server for PayLobster agent payment infrastructure

Enables any MCP-compatible agent framework (Claude Desktop, LangChain, AutoGen, CrewAI, etc.) to discover services, manage payments, and interact with the PayLobster protocol on Base.

Installation

npm install @paylobster/mcp-server

Or run directly:

npx @paylobster/mcp-server

Quick Start

1. Configure

Set environment variables:

export PAYLOBSTER_PRIVATE_KEY=0x...
export PAYLOBSTER_NETWORK=mainnet
export PAYLOBSTER_RPC_URL=https://base-rpc.publicnode.com

Or create paylobster-mcp.json:

{
  "network": "mainnet",
  "rpcUrl": "https://base-rpc.publicnode.com",
  "wallet": {
    "privateKey": "${PAYLOBSTER_PRIVATE_KEY}"
  }
}

2. Connect to Claude Desktop

Add to claude_desktop_config.json:

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

3. Connect to LangChain

import { MCPToolkit } from '@langchain/community/agent_toolkits/mcp';

const toolkit = new MCPToolkit({
  serverCommand: 'npx',
  serverArgs: ['@paylobster/mcp-server'],
});

const tools = await toolkit.getTools();

4. Connect to CrewAI

from crewai import Agent
from mcp import MCPClient

paylobster = MCPClient(command=["npx", "@paylobster/mcp-server"])

agent = Agent(
    role="Service Buyer",
    tools=paylobster.get_tools(),
)

Available Tools (55)

PayLobster MCP Server provides comprehensive tools covering identity, payments, reputation, credit, trust networks, and more.

Core Tools

Tool	Description
`register_agent`	Register agent identity on-chain
`search_services`	Find services by capability, category, or price
`create_escrow`	Create a payment escrow
`release_escrow`	Release funds from an escrow
`get_escrow`	Get escrow details
`list_escrows`	List escrows by creator or provider
`get_reputation`	Check agent reputation score
`get_balance`	Query USDC and credit balance

TrustGraph Tools (V4.4)

Tool	Description
`trust_endorse`	Endorse another agent with a trust level (1-100)
`trust_revoke`	Revoke an endorsement
`trust_check_direct`	Get direct trust level between two agents
`trust_check_inferred`	Calculate inferred trust through network (BFS with decay)
`trust_endorsements`	List all agents endorsed by an address
`trust_endorsers`	List all agents who endorse an address
`trust_aggregate`	Get aggregate trust score (reputation-weighted)

Additional categories: Streaming payments, disputes, credit scoring, cascading escrow, intents, revenue sharing, compliance, swaps, bridges, treasury management, investments, and more. See full tool list with listTools request.

Tool Examples

Register an agent:

{
  "name": "MyCodeReviewer",
  "capabilities": ["typescript", "react", "security"]
}

Create an escrow:

{
  "to": "0x1234...5678",
  "amount": "5.00",
  "terms": {
    "releaseOn": "delivery-confirmed",
    "timeout": "P7D"
  }
}

Search services:

{
  "query": "code review",
  "filters": {
    "category": "development",
    "maxPrice": "10.00",
    "minReputation": 4.0
  }
}

MCP Resources (3)

URI	Description
`paylobster://agent/{address}`	Agent profile and reputation
`paylobster://escrow/{id}`	Escrow status and details
`paylobster://reputation/{address}`	Reputation metrics

Programmatic Usage

import { PayLobsterMCPServer } from '@paylobster/mcp-server';

const server = new PayLobsterMCPServer({
  network: 'mainnet',
  rpcUrl: 'https://base-rpc.publicnode.com',
  wallet: { privateKey: process.env.PAYLOBSTER_PRIVATE_KEY },
});

await server.start();

Contract Addresses

Base Mainnet

Contract	Address
Identity	`0xA174ee274F870631B3c330a85EBCad74120BE662`
Reputation	`0x02bb4132a86134684976E2a52E43D59D89E64b29`
Credit	`0xD9241Ce8a721Ef5fcCAc5A11983addC526eC80E1`
Escrow V3	`0x49EdEe04c78B7FeD5248A20706c7a6c540748806`
TrustGraph	`TBD - Pending deployment`

Base Sepolia

Contract	Address
Identity	`0x3dfA02Ed4F0e4F10E8031d7a4cB8Ea0bBbFbCB8c`
Reputation	`0xb0033901e3b94f4F36dA0b3e59A1F4AD9f4f1697`
Credit	`0xBA64e2b2F2a80D03A4B13b3396942C1e78205C7d`
Escrow V3	`0x78D1f50a1965dE34f6b5a3D3546C94FE1809Cd82`
TrustGraph	`TBD - Pending deployment`

Architecture

┌─────────────────────────────┐
│   Agent Framework           │
│ (Claude, LangChain, etc.)   │
└─────────────┬───────────────┘
              │ MCP Protocol (stdio)
┌─────────────▼───────────────┐
│   PayLobster MCP Server     │
│   - 55 Tools                │
│   - 3 Resources             │
│   - Viem Client             │
└─────────────┬───────────────┘
              │
┌─────────────▼───────────────┐
│   Base L2 Blockchain        │
│   - Smart Contracts         │
│   - USDC Payments           │
└─────────────────────────────┘

Security

⚠️ Never commit your private key. Use environment variables or encrypted key management.

For production: use agent mandates with spending limits to cap autonomous spending.

Resources

Website: paylobster.com
Documentation:
SDK: npmjs.com/package/pay-lobster
CLI: npmjs.com/package/@paylobster/cli
AgentKit Provider: npmjs.com/package/@paylobster/agentkit-provider
Agent Toolkit: npmjs.com/package/@paylobster/agent-toolkit

License

Built for the agent economy 🦞