"""MCP Server with x402 Paid Tools - Existing Server Integration. This example demonstrates the LOW-LEVEL API using create_payment_wrapper. Use this approach when you have an EXISTING MCP server and want to add x402 payment to specific tools without adopting the full x402MCPServer abstraction. Run with: python main.py existing """ import json import os import random import sys from typing import Any from dotenv import load_dotenv from mcp.server.fastmcp import Context, FastMCP from mcp.types import CallToolResult from x402.http import FacilitatorConfig, HTTPFacilitatorClientSync from x402.mechanisms.evm.exact import ExactEvmServerScheme from x402.mcp import ( MCPToolResult, ResourceInfo, SyncPaymentWrapperConfig, create_payment_wrapper_sync, wrap_fastmcp_tool_sync, ) from x402.schemas import ResourceConfig from x402.server import x402ResourceServerSync load_dotenv() EVM_ADDRESS = os.getenv("EVM_ADDRESS") FACILITATOR_URL = os.getenv("FACILITATOR_URL", "https://x402.org/facilitator") PORT = int(os.getenv("PORT", "4022")) if not EVM_ADDRESS: print("EVM_ADDRESS environment variable is required") sys.exit(1) def get_weather_data(city: str) -> dict[str, Any]: """Simulate fetching weather data for a city.""" conditions = ["sunny", "cloudy", "rainy", "snowy", "windy"] weather = random.choice(conditions) temperature = random.randint(40, 80) return {"city": city, "weather": weather, "temperature": temperature} def run_existing() -> None: """Main entry point - Demonstrates adding x402 to an existing MCP server.""" print("\n Using LOW-LEVEL API (create_payment_wrapper with existing server)\n") # ======================================================================== # STEP 1: Your existing MCP server (this might already exist in your code) # ======================================================================== mcp_server = FastMCP("x402-mcp-server-existing", host="0.0.0.0", port=PORT) # ======================================================================== # STEP 2: Set up x402 resource server for payment handling # ======================================================================== facilitator_client = HTTPFacilitatorClientSync(FacilitatorConfig(url=FACILITATOR_URL)) resource_server = x402ResourceServerSync(facilitator_client) resource_server.register("eip155:84532", ExactEvmServerScheme()) resource_server.initialize() # ======================================================================== # STEP 3: Build payment requirements # ======================================================================== weather_accepts = resource_server.build_payment_requirements( ResourceConfig( scheme="exact", network="eip155:84532", pay_to=EVM_ADDRESS, price="$0.001", extra={"name": "USDC", "version": "2"}, ) ) forecast_accepts = resource_server.build_payment_requirements( ResourceConfig( scheme="exact", network="eip155:84532", pay_to=EVM_ADDRESS, price="$0.005", extra={"name": "USDC", "version": "2"}, ) ) # ======================================================================== # STEP 4: Create payment wrappers # ======================================================================== paid_weather = create_payment_wrapper_sync( resource_server, SyncPaymentWrapperConfig(accepts=weather_accepts, resource=ResourceInfo(url="mcp://tool/get_weather")), ) paid_forecast = create_payment_wrapper_sync( resource_server, SyncPaymentWrapperConfig(accepts=forecast_accepts, resource=ResourceInfo(url="mcp://tool/get_forecast")), ) # ======================================================================== # STEP 5: Register tools - wrap handlers with payment # ======================================================================== paid_weather_tool = wrap_fastmcp_tool_sync( paid_weather, lambda args, _: MCPToolResult( content=[{"type": "text", "text": json.dumps(get_weather_data(args["city"]), indent=2)}], ), tool_name="get_weather", ) paid_forecast_tool = wrap_fastmcp_tool_sync( paid_forecast, lambda args, _: MCPToolResult( content=[{"type": "text", "text": json.dumps( [{**get_weather_data(args["city"]), "day": i + 1} for i in range(7)], indent=2, )}], ), tool_name="get_forecast", ) # Free tool - works exactly as before, no changes needed @mcp_server.tool() def ping() -> str: """A free health check tool.""" return "pong" @mcp_server.tool() def get_weather(city: str, ctx: Context) -> CallToolResult: """Get current weather for a city. Requires payment of $0.001.""" return paid_weather_tool({"city": city}, ctx) @mcp_server.tool() def get_forecast(city: str, ctx: Context) -> CallToolResult: """Get 7-day weather forecast. Requires payment of $0.005.""" return paid_forecast_tool({"city": city}, ctx) # Run server with SSE transport (interoperable with Go/TypeScript clients) print(f"Existing MCP Server with x402 running on http://localhost:{PORT}") print("\nAvailable tools:") print(" - get_weather (paid: $0.001)") print(" - get_forecast (paid: $0.005)") print(" - ping (free)") print(f"\nConnect via SSE: http://localhost:{PORT}/sse\n") mcp_server.run(transport="sse")