@warppay402/warppay402-mcp-tools

Pay-per-use AI tools monetized via x402 USDC micropayments on Base Mainnet. Includes web scraping, Base analytics, and PDF text extraction.

Overview

This skill provides seamless access to monetized API developer tools powered by x402 USDC micropayments on Base Mainnet. Autonomous AI agents can invoke scraping, blockchain analytics, and document parsing endpoints directly using @warppay402/sdk.

Available Tools & Pricing

Web Scraper & Markdown Extractor: Extract raw HTML and Markdown content from web URLs ($0.01 USDC on Base Mainnet). Endpoint: POST https://api.warppay402.com/api/v1/tools/web-scraper Body: { "url": "https://example.com" } Base Wallet Analytics: Query transaction history and wallet metrics on Base ($0.02 USDC on Base Mainnet). Endpoint: POST https://api.warppay402.com/api/v1/tools/base-analytics Body: { "address": "0x556c77792642E8ff95eC930FFb8D46a76579126E" } PDF Text Extractor: Parse and extract plain text from hosted PDF documents ($0.05 USDC on Base Mainnet). Endpoint: POST https://api.warppay402.com/api/v1/tools/pdf-extractor Body: { "pdfUrl": "https://example.com/document.pdf" }

Discovery Endpoints

OpenAPI Spec: https://api.warppay402.com/openapi.json MCP Manifest: https://api.warppay402.com/.well-known/mcp.json

Installation

openclaw plugins install clawhub:@warppay402/warppay402-mcp-tools

Environment Setup

Configure your agent private key in your .env file:

CUSTOMER_PRIVATE_KEY=0xYourPrivateKeyHere

Usage Example

import { WarpPayClient } from "@warppay402/sdk";

export async function executeMcpTool(endpoint, payload) {
  const privateKey = process.env.CUSTOMER_PRIVATE_KEY || process.env.WALLETPK;
  if (!privateKey) {
    console.error("Error: CUSTOMER_PRIVATE_KEY or WALLETPK required.");
    process.exit(1);
  }

  const client = new WarpPayClient({ privateKey });
  try {
    const result = await client.request(endpoint, payload);
    return result;
  } catch (err) {
    console.error("x402 Execution Error:", err.message);
  }
}

Specifications

• Network: Base Mainnet (chain ID 8453)
• SDK Dependency: @warppay402/sdk (^1.0.4)
• Version: 1.0.1