@warppay402/warppay402-mcp-tools

Pay-per-use AI tools monetized via x402 USDC micropayments on Base Mainnet and Solana Mainnet-Beta. This plugin exposes web scraping, browser rendering, analytics, PDF parsing, contract verification, and signed data feeds for autonomous AI agents.

Overview

This skill gives AI agents direct access to monetized developer endpoints powered by @warppay402/sdk. The plugin is designed for OpenClaw-compatible agent environments and supports micropayments without subscription-based API keys.

• Base URL: https://api.warppay402.com

• Protocol: x402 micropayments

• Accepted assets: USDC on Base (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) and USDC on Solana (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v)

Related MCP server: Santos Automation

Available Tools & Pricing

1. Public Attestation Data Feed

• Price: $0.001 USDC

• Endpoint: GET https://api.warppay402.com/public_data_feed/{filename}

• Description: Returns signed attestation JSON payloads and public oracle data feeds.

2. Pre-Scraped Intelligence Feeds

• Price: $0.05 USDC

• Endpoint: GET https://api.warppay402.com/api/v1/feeds/{feedId}

• Description: Fetches cached live intelligence reports such as market trends and Base yield data.

3. Web Scraper & Markdown Extractor

• Price: $0.01 USDC

• Endpoint: POST https://api.warppay402.com/api/v1/tools/web-scraper

• Payload: { "url": "https://example.com" }

• Description: Pulls public webpage content and normalizes it into AI-friendly Markdown.

4. JavaScript Headless Browser Scraper

• Price: $0.05 USDC

• Endpoint: POST https://api.warppay402.com/api/v1/tools/browser-scraper

• Payload: { "url": "https://example.com" }

• Description: Renders client-side JavaScript content through distributed browser workers.

5. Base Wallet & Token Analytics

• Price: $0.02 USDC

• Endpoint: POST https://api.warppay402.com/api/v1/tools/base-analytics

• Payload: { "address": "0x556c77792642e8ff95ec930ffb8d46a76579126e" }

• Description: Queries Base Mainnet balance, nonce, and transaction metrics for an address.

6. PDF Document Extractor

• Price: $0.05 USDC

• Endpoint: POST https://api.warppay402.com/api/v1/tools/pdf-extractor

• Payload: { "pdfUrl": "https://example.com/document.pdf" }

• Description: Downloads and extracts readable text from hosted PDF files.

7. Full-Page Render & Screenshot

• Price: $0.10 USDC

• Endpoint: POST https://api.warppay402.com/api/v1/tools/render-screenshot

• Payload: { "url": "https://example.com" }

• Description: Produces rendered full-page screenshot output for visual inspection.

8. Structured JSON Schema Extractor

• Price: $0.15 USDC

• Endpoint: POST https://api.warppay402.com/api/v1/tools/extract-json

• Payload: { "url": "https://example.com", "schema": {} }

• Description: Extracts structured data that matches a target schema from a webpage.

9. Base Smart Contract Verifier

• Price: $0.35 USDC

• Endpoint: POST https://api.warppay402.com/api/v1/tools/smart-contract-verifier

• Payload: { "address": "0x456CdEC6ccf1FE853563a0fBa2BA72DE9266aD0E" }

• Description: Checks Basescan verification status, compiler settings, ABI metadata, and proxy implementations.

Discovery Endpoints

• A2A Agent Manifest: GET https://api.warppay402.com/.well-known/agent.json

• MCP Manifest: GET https://api.warppay402.com/.well-known/mcp.json

• OpenAPI Specification: GET https://api.warppay402.com/openapi.json

• LLMs Text Interface: GET https://api.warppay402.com/llms.txt

Installation

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

Environment Setup

Set your private key in your environment or .env file:

CUSTOMER_PRIVATE_KEY=0xYourPrivateKeyHere

If your environment uses a different variable name, the SDK wrapper also accepts WALLETPK.

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 || err);
    throw err;
  }
}

Specifications

• Network: Base Mainnet (chain ID 8453) and Solana Mainnet-Beta

• SDK Dependency: @warppay402/sdk (^1.0.4)

• Plugin Version: 1.1.0

• Plugin Type: OpenClaw plugin