402s.shop

Name: 402s.shop
Author: 402shop

@402shop

Repository

About 402s.shop

HTTP 402 + USDC pay-per-call API for AI agents. 16 endpoints (QR codes,

#x402 #payments #usdc #base #agentic #paid-api #mcp #scraping #qr-code #summarization #ens #wallet #gas #crypto

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "402s-shop": {
      "url": "https://402s.shop/api/mcp",
      "headers": {
        "Authorization": "Bearer ap_live_..."
      }
    }
  }
}

Tools

Generate a QR code PNG from text or URL.

Generate a 1200x630 social media OG image with title + subtitle.

Take a PNG screenshot of any URL using headless Chromium.

Render any URL to a print-ready PDF.

Count words and reading time on any webpage.

Extract Open Graph, Twitter card, and standard meta tags from any URL.

Find email addresses on a webpage (mailto links + body text), deduplicated.

Detect framework, CMS, analytics, and hosting/CDN of any website.

WHOIS lookup with normalized fields (registrar, dates, nameservers, status).

Check whether a domain appears available (heuristic via WHOIS, best-effort).

Fetch a YouTube video transcript with timestamps.

AI-powered summary (Claude Haiku 4.5) of supplied text or fetched URL.

Crypto spot prices in USD via CoinGecko. Supports BTC, ETH, USDC, USDT, SOL, XMR, and 25+ tickers.

Resolve ENS name to address (forward) or address to primary ENS name (reverse). Includes avatar where available.

Native + USDC balance for an EVM address across multiple chains. Defaults to Base + Ethereum.

Current gas price in gwei across EVM chains. Defaults to Base + Ethereum.

Hyperliquid perp + spot universe metadata: asset names, leverage caps, size decimals, spot tokens. Read-only proxy of /info type=meta + spotMeta. Phase 1 (read-only) — trading endpoints arrive in Phase 2.

Hyperliquid L2 orderbook snapshot (bids + asks) for a coin.

Hyperliquid predicted funding rates per coin per venue. Body { coin } filters to one asset; omit for full list.

Hyperliquid OHLCV candles. Default window: last 24h of given interval.

Hyperliquid recent public trades for a coin (up to ~10 most recent fills with price, size, side).

Hyperliquid account margin summary, withdrawable, total notional, maintenance margin used.

Hyperliquid open positions with size, entry price, unrealized PnL, leverage, liquidation price, cumulative funding.

Hyperliquid open orders for an address (oid, coin, side, limit price, size, timestamp).

Hyperliquid trade fills for an address (up to 2000 most recent: price, size, side, fee, closedPnl, hash).

Check whether a Hyperliquid main wallet has approved the 402s.shop builder code (5 bps). FREE — onboarding helper. Returns approved/maxFeeBps/sufficient flags. If not approved or insufficient, use hl_builder_approve_tx to construct an unsigned EIP-712 transaction.

Returns an UNSIGNED EIP-712 typed-data structure for approving the 402s.shop builder code on Hyperliquid. The agent's MAIN wallet signs locally, then POSTs { action, nonce, signature } to the returned submission_target. Server never sees main-wallet keys. FREE — onboarding helper. After approval, hl_builder_check returns sufficient=true and trading endpoints become available.

Place an order on Hyperliquid. Phase 2: TESTNET only. Mode 1 stateless: agent signs the action client-side with @nktkas/hyperliquid SDK including the builder field {b: HL_BUILDER_ADDRESS, f: 50}, then POSTs the signed payload + agentAddress. Server validates schema, all 4 sanity guards (notional/asset/depth/post-margin), rate-limits, forwards unmodified to HL. Cloid required (16-byte hex), reused across retries for idempotency. 0.005 USDC on x402; 1 credit on Bearer.

Cancel an existing Hyperliquid order by oid (numeric) or cloid (hex32). Phase 2: TESTNET only. No sanity guards (cancels reduce risk; HL handles already-canceled idempotency). 0.005 USDC on x402.

Modify an open Hyperliquid order — full sanity-guard suite on the new params (same rigor as place). Phase 2: TESTNET only. Action carries the replacement order entry alongside target oid/cloid. 0.005 USDC on x402.

Close (or reduce) a Hyperliquid position via a reduceOnly=true signed order. Phase 2: TESTNET only. Server enforces reduceOnly invariant; otherwise rejects with reduce_only_required (use hl_order_place). No notional/depth/margin caps (close reduces risk). 0.01 USDC on x402.

Set leverage on a Hyperliquid asset (1-50, cross or isolated). Phase 2: TESTNET only. Pragmatic margin sanity: rejects if account is currently underwater (margin ratio < 5%). HL is authoritative on per-position maintenance-margin specifics. 0.005 USDC on x402.

Adjust isolated-position margin on Hyperliquid. ntli > 0 adds margin (no checks); ntli < 0 withdraws margin (post-withdrawal margin ratio sanity check applies). Phase 2: TESTNET only. 0.005 USDC on x402.

Overview

What is 402s.shop?

402s.shop is a pay-per-call HTTP 402 endpoint service for AI agents, offering 16 tools with two payment rails: the x402 rail (autonomous USDC pay-per-call on Base mainnet via Coinbase CDP facilitator, no signup, sub-cent per call, verified end‑to‑end with real USDC) and the Credits rail (pre‑paid credits via NowPayments – card or 100+ cryptos, same endpoints, Bearer auth, $1 = 5 calls). The same hosted MCP server exposes all 16 tools natively for Claude Desktop, Cursor, Cline, and Claude Code.

How to use 402s.shop?

Add the server to your MCP client configuration with the URL https://402s.shop/api/mcp and an Authorization: Bearer ap_live_... header. Buy credits at https://402s.shop ($1 = 5 calls) or skip credits and use the x402 rail with any USDC‑funded wallet on Base. Each successful call deducts 1 credit; failed calls are not charged.

Key features of 402s.shop

16 pay‑per‑call tools, no subscription required
Two payment rails: x402 (USDC) and Credits (card/crypto)
$1 = 5 calls with credits; sub‑cent per call with x402
No signup or API key needed for the x402 rail
Verified end‑to‑end on Base mainnet with real USDC
Image responses (QR, OG, screenshot) as native MCP image content

Use cases of 402s.shop

AI agents autonomously paying per API call without manual billing
Fetching web content (screenshots, PDFs, metadata, transcripts) on demand
Generating QR codes, OG images, and domain checks
Retrieving crypto prices, ENS resolutions, wallet balances, and gas fees
Prototyping and production use with instant pay‑per‑call pricing

FAQ from 402s.shop

What tools does 402s.shop offer?

12 web utilities (qr_code, og_image, screenshot, pdf_from_url, word_count, extract_metadata, extract_emails, website_tech, whois, domain_check, youtube_transcript, summarize) and 4 crypto tools (coin_price, ens_resolve, wallet_balance, gas_price).

How do I pay for calls?

You can use the x402 rail (autonomous USDC on Base, no signup, sub‑cent per call) or pre‑buy credits via NowPayments using a card or 100+ cryptocurrencies ($1 = 5 calls). Both rails work with the same endpoints.