io.github.virgen101/xportalx
Official29 toolsxportalx
AI agent gateway with web fetching, data extraction, crypto pricing, and x402 payments
AI agent gateway providing web fetching, data extraction, crypto pricing, and payments.
Captured live from the server via tools/list.
fetch_api
Fetch structured JSON/XML data from any API endpoint. Best for REST APIs and data feeds. Cost: 0.01 USDC
Parameters (4)
- urlstringrequired
The API endpoint URL to fetch
- methodstring
- headersobject
Optional HTTP headers
- bodyobject
Optional request body for POST/PUT
fetch_page
Fetch raw HTML content from any web page. Best for static HTML scraping. Cost: 0.01 USDC
Parameters (2)
- urlstringrequired
The web page URL to fetch
- methodstring
fetch_pdf
Fetch and extract text content from PDF documents. Returns structured text with page numbers. Cost: 0.01 USDC
Parameters (1)
- urlstringrequired
The URL of the PDF document to fetch and parse
extract
Extract structured data from a web page using a JSON schema. AI-powered extraction. Cost: 0.01 USDC
Parameters (3)
- urlstringrequired
The web page URL to extract from
- schemastringrequired
JSON schema string defining the data structure to extract
- intentstring
Natural language description of what to extract
crawl
Crawl a website starting from a URL, following links up to specified depth. Cost: 0.01 USDC
Parameters (3)
- urlstringrequired
The starting URL to crawl
- maxPagesnumber
Maximum pages to crawl (default: 10)
- maxDepthnumber
Maximum link depth (default: 2)
markdown_convert
Convert a web page to clean Markdown format. Great for LLM consumption. Cost: 0.01 USDC
Parameters (1)
- urlstringrequired
The web page URL to convert
dexscreener_token
Get real-time token price and market data from DexScreener. FREE - no payment required.
Parameters (2)
- tokenAddressstringrequired
The token contract address
- chainstring
Blockchain (e.g., 'base', 'ethereum')
coinbase_price
Get cryptocurrency prices and exchange rates from Coinbase. FREE - no payment required.
Parameters (2)
- symbolstringrequired
Crypto symbol (e.g., 'BTC', 'ETH')
- currencystring
Fiat currency (e.g., 'USD')
verify_agent
Verify a wallet signature (EIP-191) to authenticate an agent. FREE - no payment required.
Parameters (3)
- messagestringrequired
The message that was signed
- signaturestringrequired
The signature to verify
- wallet_addressstringrequired
The wallet address that signed
coinbase_facilitator
x402 payment facilitation - get payment info, verify transactions, check rates. FREE
Parameters (5)
- actionstringrequired
Facilitator action
- txHashstring
Transaction hash (for verify)
- expectedAmountstring
Expected amount (for verify)
- expectedRecipientstring
Expected recipient (for verify)
- tokenstring
Token address (for verify)
x402_proxy
Access x402-protected APIs with automatic payment. Dynamic pricing: 0.01 USDC fee + target cost. Supports USDC on Base.
Parameters (5)
- targetUrlstringrequired
The x402-protected URL to access
- targetMethodstring
HTTP method
- targetHeadersobject
Additional headers to send to target
- targetBodyobject
Request body for POST/PUT requests
- paymentProofstring
Transaction hash of USDC payment (required after initial 402 response)
x402_proxy_price
Get dynamic pricing for x402 proxy requests. FREE - returns total cost (proxy fee + target cost).
Parameters (1)
- targetUrlstringrequired
The x402-protected target URL to probe for pricing
erc8004_register
Register your AI agent on-chain with ERC-8004 Trustless Agent Identity. Cost: 0.01 USDC. You receive an NFT representing your agent identity.
Parameters (5)
- agentNamestringrequired
Name of your agent (e.g., 'MyAwesomeAgent')
- agentDescriptionstringrequired
Description of what your agent does
- recipientWalletstringrequired
Your wallet address (0x...) to receive the Agent NFT
- agentEndpointsarray
Optional array of endpoints [{name, endpoint, version}]
- paymentProofstring
Transaction hash of payment (required after initial 402 response)
failure_reason
Understand why a job failed. FREE - lookup job failures or get failure code reference.
Parameters (2)
- jobIdstring
xportalx job ID to look up failure details
- failure_codestring
Any failure code to explain (e.g., 'RATE_LIMIT_429')
mcp_pricing
Get pricing information for all MCP tools. FREE - returns cost breakdown for each tool.
No parameters.
solve_captcha
Solve captchas on protected pages and extract content. Uses 2Captcha to bypass reCAPTCHA/hCaptcha, then Claude AI selects the best tool to retrieve content. Cost: 0.01 USDC
Parameters (4)
- urlstringrequired
The captcha-protected URL to access
- captchaTypestring
Type of captcha to solve
- siteKeystring
Site key for reCAPTCHA/hCaptcha (optional - auto-detected if not provided)
- intentstring
What you want to extract from the page after solving captcha
zora_wallet
Get comprehensive Zora NFT wallet data: NFTs minted, NFTs owned, creator profile, total mints/collections, and estimated earnings. FREE - no payment required.
Parameters (2)
- addressstringrequired
Wallet address (EOA or contract) to look up
- chainstring
Chain to query (e.g., 'zora', 'base', 'ethereum')
swap
Execute a token swap on Base via 0x DEX Aggregator. AI-ENHANCED: Accepts natural language like 'swap 10 USDC for VIRTUAL'. THREE MODES: (1) PRIVY MODE (RECOMMENDED): Provide owner_wallet - uses your secure Privy custodial wallet (create one first with create_wallet tool). (2) PRIVATE KEY MODE: Provide privateKey - server signs with your key (less secure). (3) BRIDGE MODE: Provide takerAddress only - returns a URL where you sign with browser wallet. Cost: 0.10 USDC
Parameters (9)
- requeststring
Natural language swap request (e.g., 'swap 10 USDC for VIRTUAL', 'buy 100 DEGEN with USDC'). AI will extract the parameters automatically.
- owner_walletstring
RECOMMENDED: Your wallet address (0x...) that owns a Privy custodial wallet. The swap will be executed securely through your Privy wallet. Create one first using the create_wallet tool.
- privateKeystring
LEGACY: Private key (0x... hex) to sign and broadcast transactions server-side. Consider using owner_wallet with Privy instead for better security.
- takerAddressstring
User's wallet address (0x...). When provided WITHOUT owner_wallet or privateKey, returns a secure web bridge URL where user can sign transactions with their browser wallet.
- sellTokenstring
Token symbol (USDC, WETH, VIRTUAL, DEGEN, cbBTC, DAI, AERO, BRETT) OR token address (0x...)
- buyTokenstring
Token symbol (USDC, WETH, VIRTUAL, DEGEN, cbBTC, DAI, AERO, BRETT) OR token address (0x...)
- sellAmountstring
Amount to sell. Use human-readable (e.g., '1.5' for 1.5 tokens) or atomic units (e.g., '1000000' for 1 USDC). Human-readable is auto-detected.
- slippagePercentagestring
Slippage tolerance in percent (e.g., '0.5' for 0.5%). Default: 0.5
- slippageBpsstring
Slippage in basis points (e.g., '50' = 0.50%). Takes precedence over slippagePercentage.
create_wallet
Create a custodial wallet for an AI agent using Privy. Cost: 0.01 USDC. The owner wallet is automatically detected from your x402 payment - no need to provide it explicitly. The wallet can be used for automated transactions including swaps.
Parameters (2)
- owner_walletstringrequired
Your signing wallet address (0x...) that will own this custodial wallet. Used as the lookup key for future operations. TIP: many clients can also pass just the address string as arguments.
- labelstring
Optional friendly name for this wallet (e.g., 'Trading Bot', 'Payment Agent')
fund_wallet
Fund your custodial wallet with USDC. DYNAMIC PRICING: You pay (amount + 0.01 USDC fee). The owner wallet is auto-detected from your x402 payment. Example: To deposit 5 USDC, you pay 5.01 USDC and 5 USDC is transferred to your custodial wallet.
Parameters (1)
- amountstringrequired
Amount of USDC to deposit into your custodial wallet (e.g., '5' for 5 USDC). You will pay this amount plus a 0.01 USDC platform fee.
fund_wallet_eth
Fund your custodial wallet with ETH for gas. DYNAMIC PRICING: You pay the USDC equivalent of (ETH amount + 0.01 USDC fee). The owner wallet is auto-detected from your x402 payment. Example: To deposit 0.001 ETH, you pay ~$3.50 USDC (ETH value) + 0.01 USDC fee.
Parameters (1)
- amountstringrequired
Amount of ETH to deposit into your custodial wallet (e.g., '0.001' for 0.001 ETH). You will pay the USDC equivalent plus a 0.01 USDC platform fee.
withdraw_wallet
Withdraw USDC from your custodial wallet to your owner wallet. Cost: 0.01 USDC. The owner wallet is auto-detected from your x402 payment.
Parameters (1)
- amountstringrequired
Amount of USDC to withdraw from custodial wallet (e.g., '5' for 5 USDC). Must have sufficient balance.
send_tokens
Send USDC from your custodial wallet to ANY wallet address. Cost: 0.01 USDC. The sender (your custodial wallet) is auto-detected from your x402 payment. Use this to pay other agents, transfer to exchanges, or send to any address.
Parameters (2)
- to_addressstringrequired
Destination wallet address (0x...) to send USDC to. Can be any valid EVM address.
- amountstringrequired
Amount of USDC to send (e.g., '5' for 5 USDC). Must have sufficient balance in your custodial wallet.
get_wallet_balance
Check the balance of your custodial wallet. FREE - no payment required. Returns ETH and USDC balances on Base network.
Parameters (1)
- owner_walletstringrequired
Your signing wallet address (0x...) to look up the linked custodial wallet balance.
x402_send
Send USDC directly to ANY wallet address via x402 payment. Just provide to_address and amount - the flow auto-completes: 1) Pay 0.01 USDC platform fee 2) Pay the amount directly to destination. Tokens go from you to recipient. Perfect for paying agents, tipping, or sending to any address.
Parameters (2)
- to_addressstringrequired
Destination wallet address (0x...) to receive the USDC.
- amountstringrequired
Amount of USDC to send (e.g., '5' for 5 USDC).
nansen_smart_money_holdings
Screen tokens with Smart Money activity using Nansen Token Screener. Supports natural language like 'what are whales buying on base?' or 'trending tokens on solana'. Cost: 0.01 USDC
Parameters (7)
- inputstring
Natural language query (e.g., 'what are whales buying on base?', 'trending tokens this week')
- querystring
Natural language query (alternative)
- chainsarray
Chains to query (e.g., ['ethereum', 'base', 'solana', 'arbitrum'])
- chainstring
Single chain (alternative to chains array)
- limitnumber
Number of results (default: 20, max: 100)
- sortBystring
Sort field
- sortDirstring
Sort direction
nansen_smart_money_netflows
Track net capital flows from Smart Money wallets. Supports natural language like 'are whales accumulating ETH?' or 'smart money flows for PEPE last 7 days'. Cost: 0.01 USDC
Parameters (8)
- inputstring
Natural language query (e.g., 'are smart money accumulating ETH?', 'whale flows last week')
- querystring
Natural language query (alternative)
- chainsarray
Chains to query (e.g., ['ethereum', 'base', 'solana'])
- chainstring
Single chain (alternative to chains array)
- timeframestring
Timeframe for netflow data
- tokenAddressstring
Filter by specific token address OR symbol (e.g., 'PEPE', 'VIRTUAL', '0x...')
- token_addressstring
Filter by token address (alternative)
- limitnumber
Number of results (default: 20)
nansen_token_god_mode
Full token analytics with Nansen TGM. Supports natural language like 'analyze VIRTUAL token' or 'who holds the most PEPE?'. Auto-resolves token symbols to addresses. Cost: 0.01 USDC
Parameters (6)
- inputstring
Natural language query (e.g., 'analyze VIRTUAL token', 'show me PEPE holders')
- querystring
Natural language query (alternative)
- tokenAddressstring
Token contract address OR symbol (e.g., 'VIRTUAL', 'PEPE', '0x...')
- token_addressstring
Token contract address (alternative)
- chainstring
Blockchain (e.g., 'ethereum', 'base', 'solana', 'arbitrum')
- timeframestring
Timeframe for flow data
nansen_wallet_profiler
Comprehensive wallet analysis. Supports natural language like 'profile vitalik.eth' or 'what labels does 0x... have?'. Returns balances, Nansen labels, and transactions. Cost: 0.01 USDC
Parameters (7)
- inputstring
Natural language query (e.g., 'profile this wallet 0x...', 'analyze vitalik.eth')
- querystring
Natural language query (alternative)
- addressstring
Wallet address (0x...) or ENS name to analyze
- walletstring
Wallet address (alternative)
- chainsarray
Chains to query for balances/transactions
- chainstring
Single chain (alternative)
- includeTransactionsboolean
Include recent transactions (default: true)
README not available yet.
Install
claude_desktop_config.json
{
"mcpServers": {
"xportalx": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://fflpdljiuruqdnewvwkk.supabase.co/functions/v1/mcp"
]
}
}
}Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.