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

Install the base package:

pip install warppay402-mcp

This includes the required runtime dependencies (requests, langchain-core, and mcp).

If you want to run the LangChain/OpenAI or LlamaIndex examples below, install the optional integration packages:

pip install langchain-openai
pip install "warppay402-mcp[llamaindex]" llama-index-llms-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())

LlamaIndex agent usage

First, install LlamaIndex support:

pip install "warppay402-mcp[llamaindex]" llama-index-llms-openai

Then pass the converted tools directly into any LlamaIndex agent:

from llama_index.core.agent import ReActAgent
from llama_index.llms.openai import OpenAI
from warppay402_mcp import WarpPayLlamaIndexTools

# Retrieve all 29 tools wrapped as LlamaIndex FunctionTools
tools = WarpPayLlamaIndexTools.get_tools()

# Attach tools to a LlamaIndex Agent
agent = ReActAgent.from_tools(tools, llm=OpenAI(model="gpt-4o-mini"), verbose=True)

response = agent.chat("What is the current ETH/USDC spot price on Arc Mainnet?")
print(response)

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, langchain-core, and mcp as configured in the package metadata.
• langchain-openai is required only for the ChatOpenAI example.