Warppay402

Model Context Protocol (MCP) server providing pay-per-use AI developer tools, Web3 intelligence, DEX trading, and contract deployment monetized via x402 USDC micropayments across Base Mainnet (EIP-155:8453), Arbitrum One (EIP-155:42161), Arc Mainnet (EIP-155:5042), and Solana Mainnet (SPL USDC).

View on warppay402.comTry this MCPSponsored

Hosted MCP Server

npx add-mcp 'https://api.warppay402.com/mcp?v=2'

Installs into Claude Code, Codex, Cursor and more

Documentation

docs.warppay402.com

WarpPay402 Developer Documentation

Non-custodial x402 monetization server & multi-chain tool gateway for autonomous AI agents.

Welcome to the WarpPay402 developer documentation. WarpPay402 allows AI agents, scripts, and developers to access high-value web scraping, PDF parsing, smart contract verifications, Aerodrome yield execution, and Circle CCTP cross-chain transfers without managing API keys or subscription accounts.

Overview
Authentication (x402 Micropayments)
Quickstart: Python
Quickstart: TypeScript
MCP & Claude Integration
Complete API Reference (21 Tools)
Gasless Paymaster (v0.8)
Support & Assistance
MCP Server & AI Agent Discovery Endpoints

OVERVIEW

Traditional SaaS APIs require registration, credit cards, manual API key generation, and token management. WarpPay402 uses the x402 protocol to eliminate this friction entirely.

No API Keys or Sign-Ups: Agents interact directly with monetized endpoints.

Pay-Per-Use Micropayments: Requests cost fractions of a cent ($0.0001 to $5.00 USDC) signed via on-chain crypto authorizations (EIP-712 / EIP-3009).

Multi-Chain Native: Supports Base Mainnet, Solana Mainnet, Arbitrum One, and Arc Mainnet.

Authentication (x402 Micropayments)

WarpPay402 does not use Bearer tokens or static headers. Instead, authentication uses an automated 2-step HTTP request flow:

[ AI Agent / Script ] [ WarpPay402 Gateway ]

│ │

│────── 1. POST /api/v1/tools/web-scraper ─────────►│ (Unpaid)

│ │

│◄───── 2. HTTP 402 Payment Required ───────────────│ (Returns x402 Challenge)

│ (Header: PAYMENT-REQUIRED) │

│ │

│────── 3. POST /api/v1/tools/web-scraper ─────────►│ (Paid)

│ (Header: PAYMENT-SIGNATURE) │

│ │

│◄───── 4. HTTP 200 OK + Tool Output ───────────────│

Supported Payment Networks

Network CAIP-2 ID Native Token / Asset

Base Mainnet eip155:8453 USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)

Solana Mainnet solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp SPL USDC (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v)

Arc Mainnet eip155:5042 Native USDC (0x0000000000000000000000000000000000000000)

Arbitrum One eip155:42161 USDC (0xaf88d065e77c8cC2239327C5EDb3A432268e5831)

Quickstart: Python

(1) Install the official Python SDK from PyPI:

Bash

pip install warppay402-mcp

(2) Code Example:

from warppay402 import WarpPayClient

# Initialize client with your wallet's private key

client = WarpPayClient(

private_key="0x_YOUR_AGENT_PRIVATE_KEY",

gateway_url="https://api.warppay402.com"

)

# Execute the Markdown Web Scraper ($0.001 USDC)

result = client.call_tool(

"web_scraper",

payload={"url": "https://news.ycombinator.com"}

)

print(f"Title: {result['title']}")

print(f"Markdown Preview:\n{result['markdown'][:500]}")

Quickstart: TypeScript

(1) Install the official Node.js client package:

Bash

npm install @warppay402/sdk

(2) Code Example

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

const client = new WarpPayClient({

privateKey: process.env.AGENT_PRIVATE_KEY!,

baseUrl: "https://api.warppay402.com"

});

async function run() {

// Query Base wallet analytics ($0.002 USDC)

const analytics = await client.execute("base_analytics", {

address: "0x556c77792642E8ff95eC930FFb8D46a76579126E"

});

console.log("Base ETH Balance:", analytics.ethBalance);

console.log("Account Nonce:", analytics.nonce);

}

run();

MCP & Clauade Integration

Connect WarpPay402 tools directly to Claude Desktop, Cursor, or Glama AI using the Model Context Protocol (MCP).

Add the following block to your claude_desktop_config.json:

{

"mcpServers": {

"warppay402": {

"command": "npx",

"args": [

"-y",

"@warppay402/mcp-server",

"--gateway",

"https://api.warppay402.com/mcp?v=2"

]

}

Complete API Reference (21 Tools)

-public_data_feed

Method & Path: GET /public_data_feed/:file

Price (USDC): $0.0001

Description: Fetches signed public attestation JSON records.

-data_feeds

Method & Path: GET /api/v1/feeds/:feedId

Price (USDC): $0.0010

Description: Pre-scraped market intelligence and yield feeds.

-web_scraper

Method & Path: POST /api/v1/tools/web-scraper

Price (USDC): $0.0010

Description: Converts public webpages into clean Markdown for LLM contexts.

-browser_scraper

Method & Path: POST /api/v1/tools/browser-scraper

Price (USDC): $0.0050

Description: Headless Chromium scraper backed by residential proxy workers.

-base_analytics

Method & Path: POST /api/v1/tools/base-analytics

Price (USDC): $0.0020

Description: Returns ETH balance, transaction nonce, and wallet details on Base.

-arc_analytics

Method & Path: POST /api/v1/tools/arc-analytics

Price (USDC): $0.0010

Description: Fetches live block height, gas prices, and RPC status on Arc Mainnet.

-arc_network_oracle_query

Method & Path: POST /api/v1/tools/arc-network-query

Price (USDC): $0.1000

Description: Pre-flight Arc telemetry: RPC latency (ms), gas trends, and balance.

-arc_dex_oracle

Method & Path: POST /api/v1/tools/arc-dex-oracle

Price (USDC): $0.0010

Description: Real-time ETH/USDC spot price resolver for Arc Mainnet pools.

-pdf_extractor

Method & Path: POST /api/v1/tools/pdf-extractor

Price (USDC): $0.0050

Description: Downloads and parses public PDF documents into plain text.

-render_screenshot

Method & Path: POST /api/v1/tools/render-screenshot

Price (USDC): $0.0100

Description: Captures full-page rendered screenshot image data.

-extract_json

Method & Path: POST /api/v1/tools/extract-json

Price (USDC): $0.0100

Description: Extracts structured JSON schema data from HTML web pages.

-smart_contract_verifier

Method & Path: POST /api/v1/tools/smart-contract-verifier

Price (USDC): $0.0200

Description: Basescan source code analysis, bytecode validation, and ABI fetching.

-get_aerodrome_yields

Method & Path: GET /api/v1/tools/aerodrome-yields

Price (USDC): $0.0030

Description: Real-time Aerodrome DEX yield opportunities, pool APYs, and TVL.

-aerodrome_swap

Method & Path: POST /api/v1/tools/aerodrome-swap

Price (USDC): $0.0100

Description: Programmatic token swaps executed via Aerodrome Finance Router.

-aerodrome_clamm

Method & Path: POST /api/v1/tools/aerodrome-clamm

Price (USDC): $0.0100

Description: Concentrated liquidity (Slipstream) position management.

-aerodrome_veaero

Method & Path: POST /api/v1/tools/aerodrome-veaero

Price (USDC): $0.0100

Description: Automates $AERO locking, epoch gauge voting, and bribe harvesting.

-deploy_contract

Method & Path: POST /api/v1/tools/deploy-contract

Price (USDC): $5.0000

Description: Deploys custom Escrow, Bounty, or Agent contracts to Base.

-deploy_solana_contract

Method & Path: POST /api/v1/tools/deploy-solana-contract

Price (USDC): $5.0000

Description: Programmatically initializes SPL Escrows or Raydium Vaults on Solana.

-deploy_arc_contract

Method & Path: POST /api/v1/tools/deploy-arc-contract

Price (USDC): $5.0000

Description: Deploys Escrow, Bounty, or Agent contracts directly to Arc Mainnet.

-arc_cctp_bridge

Method & Path: POST /api/v1/tools/arc-cctp-bridge

Price (USDC): $0.2500

Description: Cross-chain USDC transfers from Arc Mainnet via Circle CCTP V2.

-x402_telemetry_feed

Method & Path: GET /api/v1/telemetry/settlements

Price (USDC): Free

Description: Public settlement telemetry, active endpoints, and on-chain proofs.

Gasless Paymaster (ERC-4337 / ERC-7677 v0.8)

WarpPay402 hosts an integrated v0.8 Paymaster on Base Mainnet. Smart Accounts holding USDC can execute gasless transaction bundles using USDC markup billing.

Paymaster RPC Endpoint: [https://api.warppay402.com/api/v1/paymaster/rpc\](https://api.warppay402.com/api/v1/paymaster/rpc)

Quote Endpoint: [https://api.warppay402.com/api/v1/paymaster/quote\](https://api.warppay402.com/api/v1/paymaster/quote)