warppay402-mcp

LangChain-compatible BaseTool wrappers for WarpPay402 x402 micropayment APIs.

Overview

This package provides a toolkit of agent-ready tools for on-chain analytics, web extraction, automation, and DeFi actions. The tools are implemented in warppay402_mcp.tools and use the WarpPay402 API endpoints under https://api.warppay402.com/api/v1/tools.

Accepted payment options

The WarpPay402 server accepts the following payment methods for tool usage:

• Base USDC
• Arbitrum One USDC
• Solana USDC
• Arc USDC

Installation

pip install warppay402-mcp

If you want to run the LangChain/OpenAI example below, install the optional integration package:

pip install langchain-openai

Available tools

The package currently includes these tools:

This table is meant to make it easy for developers to point agents at the right server capability and understand the expected inputs and pricing before invoking a tool.

Quickstart

Direct tool usage

from warppay402_mcp.tools import ArcDexOracleTool, AerodromeYieldsTool, WebScraperTool

oracle = ArcDexOracleTool()
print(oracle.run("ETH/USDC"))

yields_tool = AerodromeYieldsTool()
print(yields_tool.run())

scraper = WebScraperTool()
print(scraper.run("https://example.com"))

LangChain agent usage

from langchain.agents import AgentType, initialize_agent
from langchain_openai import ChatOpenAI

from warppay402_mcp.tools import ArcDexOracleTool

llm = ChatOpenAI(model="gpt-4o-mini")
tools = [ArcDexOracleTool()]

agent = initialize_agent(
    tools=tools,
    llm=llm,
    agent=AgentType.STRUCTURED_CHAT_ZERO_SHOT_REACT_DESCRIPTION,
)

result = agent.invoke("What is the current ETH/USDC spot price?")
print(result)

Example tool details

ArcDexOracleTool

• Name: arc_dex_oracle
• Description: Real-time ETH/USDC spot price resolver and DEX liquidity oracle for Arc Mainnet ($0.001 USDC).
• Default pair: ETH/USDC

from warppay402_mcp.tools import ArcDexOracleTool

tool = ArcDexOracleTool()
print(tool.run("ETH/USDC"))

AerodromeYieldsTool

• Name: get_aerodrome_yields
• Description: Fetches top live Aerodrome DEX yield pools, APYs, and TVL on Base Mainnet ($0.003 USDC).

from warppay402_mcp.tools import AerodromeYieldsTool

tool = AerodromeYieldsTool()
print(tool.run())

Notes

• The package exports ArcDexOracleTool at the package root, but the full tool set is defined in warppay402_mcp.tools.
• Many tools accept simple Python arguments and return raw API response text as a string.
• This project depends on requests and langchain-core as configured in the package metadata.
• langchain-openai is required only for the ChatOpenAI example.