# @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`)

## 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

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

## Environment Setup

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

```dotenv
CUSTOMER_PRIVATE_KEY=0xYourPrivateKeyHere
```

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

## Usage Example

```javascript
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