warppay402-mcp 1.1.0__tar.gz

warppay402_mcp-1.1.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: warppay402-mcp
+Version: 1.1.0
+Summary: LangChain and CrewAI tool wrappers for WarpPay402 x402 micropayment APIs
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Requires-Dist: langchain-core>=0.1.0
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: summary
+
+# warppay402-mcp
+
+LangChain and CrewAI native `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
+
+```bash
+pip install warppay402-mcp
+```
+
+If you want to run the LangChain/OpenAI example below, install the optional integration package:
+
+```bash
+pip install langchain-openai
+```
+
+## Available tools
+
+The package currently includes these tools:
+
+| Tool | Server capability | Typical call signature |
+| --- | --- | --- |
+| `ArcDexOracleTool` | Arc DEX spot price & liquidity oracle | `run(pair="ETH/USDC")` |
+| `WebScraperTool` | Public webpage to Markdown extraction | `run(url)` |
+| `BrowserScraperTool` | JS-rendered page scraping via browser | `run(url)` |
+| `BaseAnalyticsTool` | Wallet balance / nonce / account stats on Base | `run(address)` |
+| `ArcAnalyticsTool` | Arc network block / gas / latency telemetry | `run()` |
+| `ArcNetworkQueryTool` | Pre-flight Arc node + gas + merchant checks | `run(includeGasTrends=True, checkMerchantAccount=True)` |
+| `PdfExtractorTool` | Public PDF text extraction | `run(pdfUrl)` |
+| `RenderScreenshotTool` | Full-page screenshot capture | `run(url)` |
+| `ExtractJsonTool` | Schema-driven JSON extraction from HTML | `run(url, schema=None)` |
+| `SmartContractVerifierTool` | Contract source / ABI / proxy verification | `run(address)` |
+| `AerodromeYieldsTool` | Top yield pools and APY data | `run()` |
+| `AerodromeSwapTool` | Aerodrome router token swap execution | `run(tokenIn, tokenOut, amountIn, decimalsIn, isStable)` |
+| `AerodromeClammTool` | Constrained liquidity range actions | `run(action, token0=None, token1=None, tickLower=None, tickUpper=None, amount0Desired=None, amount1Desired=None, tokenId=None)` |
+| `AerodromeVeaeroTool` | Lock / vote / claim AERO governance actions | `run(action, amount=None, lockDurationWeeks=None, tokenId=None, poolVoteAddresses=None)` |
+| `DeployBaseContractTool` | Deploy contracts on Base | `run(contractType="escrow")` |
+| `DeploySolanaContractTool` | Deploy Solana contracts / vaults | `run(contractType, params)` |
+| `DeployArcContractTool` | Deploy contracts on Arc | `run(contractType="escrow")` |
+| `ArcCctpBridgeTool` | Cross-chain USDC bridge via CCTP | `run(amountUsdc, destinationChain, recipientAddress)` |
+| `PublicDataFeedTool` | Signed public data feed retrieval | `run(filename)` |
+| `DataFeedsTool` | Market / yield feed retrieval | `run(feedId)` |
+
+This table is meant to make it easy for developers to point agents at the right server capability and to understand the expected inputs before invoking a tool.
+
+## Quickstart
+
+### Direct tool usage
+
+```python
+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
+
+```python
+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`
+
+```python
+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).
+
+```python
+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.

warppay402_mcp-1.1.0/README.md

@@ -0,0 +1,129 @@
+# warppay402-mcp
+
+LangChain and CrewAI native `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
+
+```bash
+pip install warppay402-mcp
+```
+
+If you want to run the LangChain/OpenAI example below, install the optional integration package:
+
+```bash
+pip install langchain-openai
+```
+
+## Available tools
+
+The package currently includes these tools:
+
+| Tool | Server capability | Typical call signature |
+| --- | --- | --- |
+| `ArcDexOracleTool` | Arc DEX spot price & liquidity oracle | `run(pair="ETH/USDC")` |
+| `WebScraperTool` | Public webpage to Markdown extraction | `run(url)` |
+| `BrowserScraperTool` | JS-rendered page scraping via browser | `run(url)` |
+| `BaseAnalyticsTool` | Wallet balance / nonce / account stats on Base | `run(address)` |
+| `ArcAnalyticsTool` | Arc network block / gas / latency telemetry | `run()` |
+| `ArcNetworkQueryTool` | Pre-flight Arc node + gas + merchant checks | `run(includeGasTrends=True, checkMerchantAccount=True)` |
+| `PdfExtractorTool` | Public PDF text extraction | `run(pdfUrl)` |
+| `RenderScreenshotTool` | Full-page screenshot capture | `run(url)` |
+| `ExtractJsonTool` | Schema-driven JSON extraction from HTML | `run(url, schema=None)` |
+| `SmartContractVerifierTool` | Contract source / ABI / proxy verification | `run(address)` |
+| `AerodromeYieldsTool` | Top yield pools and APY data | `run()` |
+| `AerodromeSwapTool` | Aerodrome router token swap execution | `run(tokenIn, tokenOut, amountIn, decimalsIn, isStable)` |
+| `AerodromeClammTool` | Constrained liquidity range actions | `run(action, token0=None, token1=None, tickLower=None, tickUpper=None, amount0Desired=None, amount1Desired=None, tokenId=None)` |
+| `AerodromeVeaeroTool` | Lock / vote / claim AERO governance actions | `run(action, amount=None, lockDurationWeeks=None, tokenId=None, poolVoteAddresses=None)` |
+| `DeployBaseContractTool` | Deploy contracts on Base | `run(contractType="escrow")` |
+| `DeploySolanaContractTool` | Deploy Solana contracts / vaults | `run(contractType, params)` |
+| `DeployArcContractTool` | Deploy contracts on Arc | `run(contractType="escrow")` |
+| `ArcCctpBridgeTool` | Cross-chain USDC bridge via CCTP | `run(amountUsdc, destinationChain, recipientAddress)` |
+| `PublicDataFeedTool` | Signed public data feed retrieval | `run(filename)` |
+| `DataFeedsTool` | Market / yield feed retrieval | `run(feedId)` |
+
+This table is meant to make it easy for developers to point agents at the right server capability and to understand the expected inputs before invoking a tool.
+
+## Quickstart
+
+### Direct tool usage
+
+```python
+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
+
+```python
+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`
+
+```python
+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).
+
+```python
+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.

warppay402_mcp-1.1.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"

warppay402_mcp-1.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

warppay402_mcp-1.1.0/setup.py

@@ -0,0 +1,18 @@
+from setuptools import setup, find_packages
+from pathlib import Path
+
+this_directory = Path(__file__).parent
+long_description = (this_directory / "README.md").read_text(encoding="utf-8")
+
+setup(
+    name="warppay402-mcp",
+    version="1.1.0",
+    description="LangChain and CrewAI tool wrappers for WarpPay402 x402 micropayment APIs",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    packages=find_packages(),
+    install_requires=[
+        "requests>=2.28.0",
+        "langchain-core>=0.1.0",
+    ],
+)

warppay402_mcp-1.1.0/warppay402_mcp/__init__.py

@@ -0,0 +1,45 @@
+from .tools import (
+    ArcDexOracleTool,
+    WebScraperTool,
+    BrowserScraperTool,
+    BaseAnalyticsTool,
+    ArcAnalyticsTool,
+    ArcNetworkQueryTool,
+    PdfExtractorTool,
+    RenderScreenshotTool,
+    ExtractJsonTool,
+    SmartContractVerifierTool,
+    AerodromeYieldsTool,
+    AerodromeSwapTool,
+    AerodromeClammTool,
+    AerodromeVeaeroTool,
+    DeployBaseContractTool,
+    DeploySolanaContractTool,
+    DeployArcContractTool,
+    ArcCctpBridgeTool,
+    PublicDataFeedTool,
+    DataFeedsTool,
+)
+
+__all__ = [
+    "ArcDexOracleTool",
+    "WebScraperTool",
+    "BrowserScraperTool",
+    "BaseAnalyticsTool",
+    "ArcAnalyticsTool",
+    "ArcNetworkQueryTool",
+    "PdfExtractorTool",
+    "RenderScreenshotTool",
+    "ExtractJsonTool",
+    "SmartContractVerifierTool",
+    "AerodromeYieldsTool",
+    "AerodromeSwapTool",
+    "AerodromeClammTool",
+    "AerodromeVeaeroTool",
+    "DeployBaseContractTool",
+    "DeploySolanaContractTool",
+    "DeployArcContractTool",
+    "ArcCctpBridgeTool",
+    "PublicDataFeedTool",
+    "DataFeedsTool",
+]

warppay402_mcp-1.1.0/warppay402_mcp/tools.py

@@ -0,0 +1,188 @@
+import requests
+from typing import Optional, Dict, Any
+from langchain_core.tools import BaseTool
+
+BASE_URL = "https://api.warppay402.com/api/v1/tools"
+
+class ArcDexOracleTool(BaseTool):
+    name: str = "arc_dex_oracle"
+    description: str = "Real-time ETH/USDC spot price resolver and DEX liquidity oracle for Arc Mainnet ($0.001 USDC)."
+
+    def _run(self, pair: str = "ETH/USDC") -> str:
+        res = requests.post(f"{BASE_URL}/arc-dex-oracle", json={"pair": pair})
+        return res.text
+
+class WebScraperTool(BaseTool):
+    name: str = "web_scraper"
+    description: str = "Scrapes any public webpage URL into clean Markdown for AI context window ingestion ($0.001 USDC)."
+
+    def _run(self, url: str) -> str:
+        res = requests.post(f"{BASE_URL}/web-scraper", json={"url": url})
+        return res.text
+
+class BrowserScraperTool(BaseTool):
+    name: str = "browser_scraper"
+    description: str = "Executes unblockable JavaScript Chromium rendering via proxy workers ($0.005 USDC)."
+
+    def _run(self, url: str) -> str:
+        res = requests.post(f"{BASE_URL}/browser-scraper", json={"url": url})
+        return res.text
+
+class BaseAnalyticsTool(BaseTool):
+    name: str = "base_analytics"
+    description: str = "Fetches ETH balance, nonce, and account stats for any 0x wallet on Base Mainnet ($0.002 USDC)."
+
+    def _run(self, address: str) -> str:
+        res = requests.post(f"{BASE_URL}/base-analytics", json={"address": address})
+        return res.text
+
+class ArcAnalyticsTool(BaseTool):
+    name: str = "arc_analytics"
+    description: str = "Fetches live block height, gas price, and RPC latency from Arc Mainnet ($0.001 USDC)."
+
+    def _run(self) -> str:
+        res = requests.post(f"{BASE_URL}/arc-analytics")
+        return res.text
+
+class ArcNetworkQueryTool(BaseTool):
+    name: str = "arc_network_oracle_query"
+    description: str = "Pre-flight Arc Mainnet telemetry: RPC latency (ms), gas prices (Gwei), native USDC balance, and account nonce ($0.10 USDC)."
+
+    def _run(self, includeGasTrends: bool = True, checkMerchantAccount: bool = True) -> str:
+        payload = {"includeGasTrends": includeGasTrends, "checkMerchantAccount": checkMerchantAccount}
+        res = requests.post(f"{BASE_URL}/arc-network-query", json=payload)
+        return res.text
+
+class PdfExtractorTool(BaseTool):
+    name: str = "pdf_extractor"
+    description: str = "Downloads and extracts clean plain text preview from public PDF document URLs ($0.005 USDC)."
+
+    def _run(self, pdfUrl: str) -> str:
+        res = requests.post(f"{BASE_URL}/pdf-extractor", json={"pdfUrl": pdfUrl})
+        return res.text
+
+class RenderScreenshotTool(BaseTool):
+    name: str = "render_screenshot"
+    description: str = "Captures full-page rendered screenshot image data from target URL ($0.01 USDC)."
+
+    def _run(self, url: str) -> str:
+        res = requests.post(f"{BASE_URL}/render-screenshot", json={"url": url})
+        return res.text
+
+class ExtractJsonTool(BaseTool):
+    name: str = "extract_json"
+    description: str = "Extracts structured JSON schema data from web page HTML content ($0.01 USDC)."
+
+    def _run(self, url: str, schema: Optional[Dict[str, Any]] = None) -> str:
+        payload = {"url": url, "schema": schema or {}}
+        res = requests.post(f"{BASE_URL}/extract-json", json=payload)
+        return res.text
+
+class SmartContractVerifierTool(BaseTool):
+    name: str = "smart_contract_verifier"
+    description: str = "Source code analysis, bytecode validation, ABI fetching, and proxy detection on Basescan ($0.02 USDC)."
+
+    def _run(self, address: str) -> str:
+        res = requests.post(f"{BASE_URL}/smart-contract-verifier", json={"address": address})
+        return res.text
+
+class AerodromeYieldsTool(BaseTool):
+    name: str = "get_aerodrome_yields"
+    description: str = "Fetches top live Aerodrome DEX yield pools, APYs, and TVL on Base Mainnet ($0.003 USDC)."
+
+    def _run(self) -> str:
+        res = requests.get(f"{BASE_URL}/aerodrome-yields")
+        return res.text
+
+class AerodromeSwapTool(BaseTool):
+    name: str = "aerodrome_swap"
+    description: str = "Executes low-slippage token swaps directly via Aerodrome Finance Router on Base ($0.01 USDC)."
+
+    def _run(self, tokenIn: str, tokenOut: str, amountIn: str, decimalsIn: int, isStable: bool) -> str:
+        payload = {
+            "tokenIn": tokenIn, "tokenOut": tokenOut,
+            "amountIn": amountIn, "decimalsIn": decimalsIn, "isStable": isStable
+        }
+        res = requests.post(f"{BASE_URL}/aerodrome-swap", json=payload)
+        return res.text
+
+class AerodromeClammTool(BaseTool):
+    name: str = "aerodrome_clamm"
+    description: str = "Open, adjust, and rebalance concentrated liquidity ranges on Aerodrome Slipstream ($0.01 USDC)."
+
+    def _run(self, action: str, token0: Optional[str] = None, token1: Optional[str] = None,
+             tickLower: Optional[int] = None, tickUpper: Optional[int] = None,
+             amount0Desired: Optional[str] = None, amount1Desired: Optional[str] = None,
+             tokenId: Optional[str] = None) -> str:
+        payload = {
+            "action": action, "token0": token0, "token1": token1,
+            "tickLower": tickLower, "tickUpper": tickUpper,
+            "amount0Desired": amount0Desired, "amount1Desired": amount1Desired, "tokenId": tokenId
+        }
+        res = requests.post(f"{BASE_URL}/aerodrome-clamm", json=payload)
+        return res.text
+
+class AerodromeVeaeroTool(BaseTool):
+    name: str = "aerodrome_veaero"
+    description: str = "Automates $AERO locking, epoch gauge voting, and bribe reward harvesting on Aerodrome ($0.01 USDC)."
+
+    def _run(self, action: str, amount: Optional[str] = None, lockDurationWeeks: Optional[int] = None,
+             tokenId: Optional[str] = None, poolVoteAddresses: Optional[list] = None) -> str:
+        payload = {
+            "action": action, "amount": amount, "lockDurationWeeks": lockDurationWeeks,
+            "tokenId": tokenId, "poolVoteAddresses": poolVoteAddresses
+        }
+        res = requests.post(f"{BASE_URL}/aerodrome-veaero", json=payload)
+        return res.text
+
+class DeployBaseContractTool(BaseTool):
+    name: str = "deploy_contract"
+    description: str = "Programmatically deploys custom Escrow, Bounty, or Subscription contracts to Base Mainnet ($5.00 USDC)."
+
+    def _run(self, contractType: str = "escrow") -> str:
+        res = requests.post(f"{BASE_URL}/deploy-contract", json={"contractType": contractType})
+        return res.text
+
+class DeploySolanaContractTool(BaseTool):
+    name: str = "deploy_solana_contract"
+    description: str = "Initializes SPL Escrows, cNFT Badge Issuers, or Raydium Vaults on Solana Mainnet ($5.00 USDC)."
+
+    def _run(self, contractType: str, params: Dict[str, Any]) -> str:
+        payload = {"contractType": contractType, "params": params}
+        res = requests.post(f"{BASE_URL}/deploy-solana-contract", json=payload)
+        return res.text
+
+class DeployArcContractTool(BaseTool):
+    name: str = "deploy_arc_contract"
+    description: str = "Programmatically deploys custom Escrow, Bounty, or Agent contracts directly to Arc Mainnet ($5.00 USDC)."
+
+    def _run(self, contractType: str = "escrow") -> str:
+        res = requests.post(f"{BASE_URL}/deploy-arc-contract", json={"contractType": contractType})
+        return res.text
+
+class ArcCctpBridgeTool(BaseTool):
+    name: str = "arc_cctp_bridge"
+    description: str = "Bridges USDC cross-chain from Arc Mainnet via Circle CCTP V2 ($0.25 USDC)."
+
+    def _run(self, amountUsdc: str, destinationChain: str, recipientAddress: str) -> str:
+        payload = {
+            "amountUsdc": amountUsdc, "destinationChain": destinationChain, "recipientAddress": recipientAddress
+        }
+        res = requests.post(f"{BASE_URL}/arc-cctp-bridge", json=payload)
+        return res.text
+
+class PublicDataFeedTool(BaseTool):
+    name: str = "public_data_feed"
+    description: str = "Retrieves signed attestation JSON payloads from the public data feed ($0.0001 USDC)."
+
+    def _run(self, filename: str) -> str:
+        res = requests.get(f"https://api.warppay402.com/public_data_feed/{filename}")
+        return res.text
+
+class DataFeedsTool(BaseTool):
+    name: str = "data_feeds"
+    description: str = "Fetches pre-scraped market data feeds and yield reports ($0.001 USDC)."
+
+    def _run(self, feedId: str) -> str:
+        res = requests.get(f"https://api.warppay402.com/api/v1/feeds/{feedId}")
+        return res.text

warppay402_mcp-1.1.0/warppay402_mcp.egg-info/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: warppay402-mcp
+Version: 1.1.0
+Summary: LangChain and CrewAI tool wrappers for WarpPay402 x402 micropayment APIs
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Requires-Dist: langchain-core>=0.1.0
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: summary
+
+# warppay402-mcp
+
+LangChain and CrewAI native `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
+
+```bash
+pip install warppay402-mcp
+```
+
+If you want to run the LangChain/OpenAI example below, install the optional integration package:
+
+```bash
+pip install langchain-openai
+```
+
+## Available tools
+
+The package currently includes these tools:
+
+| Tool | Server capability | Typical call signature |
+| --- | --- | --- |
+| `ArcDexOracleTool` | Arc DEX spot price & liquidity oracle | `run(pair="ETH/USDC")` |
+| `WebScraperTool` | Public webpage to Markdown extraction | `run(url)` |
+| `BrowserScraperTool` | JS-rendered page scraping via browser | `run(url)` |
+| `BaseAnalyticsTool` | Wallet balance / nonce / account stats on Base | `run(address)` |
+| `ArcAnalyticsTool` | Arc network block / gas / latency telemetry | `run()` |
+| `ArcNetworkQueryTool` | Pre-flight Arc node + gas + merchant checks | `run(includeGasTrends=True, checkMerchantAccount=True)` |
+| `PdfExtractorTool` | Public PDF text extraction | `run(pdfUrl)` |
+| `RenderScreenshotTool` | Full-page screenshot capture | `run(url)` |
+| `ExtractJsonTool` | Schema-driven JSON extraction from HTML | `run(url, schema=None)` |
+| `SmartContractVerifierTool` | Contract source / ABI / proxy verification | `run(address)` |
+| `AerodromeYieldsTool` | Top yield pools and APY data | `run()` |
+| `AerodromeSwapTool` | Aerodrome router token swap execution | `run(tokenIn, tokenOut, amountIn, decimalsIn, isStable)` |
+| `AerodromeClammTool` | Constrained liquidity range actions | `run(action, token0=None, token1=None, tickLower=None, tickUpper=None, amount0Desired=None, amount1Desired=None, tokenId=None)` |
+| `AerodromeVeaeroTool` | Lock / vote / claim AERO governance actions | `run(action, amount=None, lockDurationWeeks=None, tokenId=None, poolVoteAddresses=None)` |
+| `DeployBaseContractTool` | Deploy contracts on Base | `run(contractType="escrow")` |
+| `DeploySolanaContractTool` | Deploy Solana contracts / vaults | `run(contractType, params)` |
+| `DeployArcContractTool` | Deploy contracts on Arc | `run(contractType="escrow")` |
+| `ArcCctpBridgeTool` | Cross-chain USDC bridge via CCTP | `run(amountUsdc, destinationChain, recipientAddress)` |
+| `PublicDataFeedTool` | Signed public data feed retrieval | `run(filename)` |
+| `DataFeedsTool` | Market / yield feed retrieval | `run(feedId)` |
+
+This table is meant to make it easy for developers to point agents at the right server capability and to understand the expected inputs before invoking a tool.
+
+## Quickstart
+
+### Direct tool usage
+
+```python
+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
+
+```python
+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`
+
+```python
+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).
+
+```python
+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.

warppay402_mcp-1.1.0/warppay402_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+setup.py
+warppay402_mcp/__init__.py
+warppay402_mcp/tools.py
+warppay402_mcp.egg-info/PKG-INFO
+warppay402_mcp.egg-info/SOURCES.txt
+warppay402_mcp.egg-info/dependency_links.txt
+warppay402_mcp.egg-info/requires.txt
+warppay402_mcp.egg-info/top_level.txt

warppay402_mcp-1.1.0/warppay402_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

warppay402_mcp-1.1.0/warppay402_mcp.egg-info/requires.txt

@@ -0,0 +1,2 @@
+requests>=2.28.0
+langchain-core>=0.1.0

warppay402_mcp-1.1.0/warppay402_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+warppay402_mcp