httpay-mcp 0.1.0

package/README.md

@@ -0,0 +1,95 @@
+# httpay-mcp
+
+MCP (Model Context Protocol) server that exposes **121+ httpay.xyz crypto API endpoints** as tools for AI assistants.
+
+## What is httpay.xyz?
+
+[httpay.xyz](https://httpay.xyz) is a crypto API bazaar with 121+ endpoints covering:
+- 🎭 **Fun** — Fortune cookies, roasts, pickup lines, rap battles
+- 🛠️ **Tools** — Gas oracle, ENS lookup, token prices, wallet risk scores
+- 📊 **Analysis** — Market sentiment, DeFi yields, token comparisons
+- 🎲 **Games** — Coin flip, magic 8-ball, crypto trivia
+- 🔮 **Predictions** — Moon predictions, vibe checks, zodiac portfolios
+- 🏗️ **Dev** — Solidity roasts, gas golfing tips, audit bingo
+- 🎪 **Novelty** — Crypto poems, dream interpreter, wen lambo calculator
+- 💬 **Social** — GM/GN messages, bio generators
+- 📦 **Proprietary** — x402 stats, ERC-8004 lookups (exclusive data)
+- 🔗 **L2 Data** — Real-time gas costs across L2s
+
+All endpoints are pay-per-call via the [x402 protocol](https://x402.org), costing $0.001–$0.05 per request.
+
+## Installation
+
+```bash
+npm install -g @anthropic-alfred/httpay-mcp
+```
+
+Or use directly with npx:
+
+```bash
+npx @anthropic-alfred/httpay-mcp
+```
+
+## Configuration
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "httpay": {
+      "command": "npx",
+      "args": ["@anthropic-alfred/httpay-mcp"],
+      "env": {
+        "HTTPAY_API_KEY": "your-api-key-if-needed"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to your MCP settings:
+
+```json
+{
+  "httpay": {
+    "command": "npx",
+    "args": ["@anthropic-alfred/httpay-mcp"]
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `HTTPAY_BASE_URL` | Base URL for httpay API | `https://httpay.xyz` |
+| `HTTPAY_API_KEY` | API key (if required) | — |
+
+## Example Usage
+
+Once connected, you can ask your AI assistant things like:
+
+- "Get me a crypto fortune cookie"
+- "What's the current gas price across chains?"
+- "Roast my wallet 0x..."
+- "Compare ETH and SOL"
+- "What's the live price of BTC?"
+- "Find the cheapest L2 for a swap"
+
+## Development
+
+```bash
+git clone https://github.com/alfredz0x/httpay-mcp
+cd httpay-mcp
+npm install
+npm run dev
+```
+
+## License
+
+MIT

package/dist/endpoints.d.ts

@@ -0,0 +1,20 @@
+/**
+ * All httpay.xyz endpoints, scraped from the site.
+ * Each entry defines the MCP tool metadata + how to call the API.
+ */
+export interface EndpointParam {
+    name: string;
+    description: string;
+    required: boolean;
+    in: "path" | "query";
+}
+export interface Endpoint {
+    name: string;
+    method: "GET";
+    path: string;
+    description: string;
+    price: string;
+    category: string;
+    params: EndpointParam[];
+}
+export declare const ENDPOINTS: Endpoint[];

package/dist/endpoints.js

@@ -0,0 +1,157 @@
+/**
+ * All httpay.xyz endpoints, scraped from the site.
+ * Each entry defines the MCP tool metadata + how to call the API.
+ */
+function ep(category, path, description, price, params = []) {
+    // Derive tool name from path: /api/roast-my-wallet/:address -> roast_my_wallet
+    const name = path
+        .replace(/^\/api\//, "")
+        .replace(/\/:[^/]+/g, "")
+        .replace(/[/-]/g, "_");
+    return { name, method: "GET", path, description, price, category, params };
+}
+const p = (name, description, inType = "path") => ({
+    name,
+    description,
+    required: true,
+    in: inType,
+});
+const qp = (name, description, required = false) => ({
+    name,
+    description,
+    required,
+    in: "query",
+});
+export const ENDPOINTS = [
+    // 🎭 Fun
+    ep("Fun", "/api/fortune", "Crypto fortune cookie", "$0.001"),
+    ep("Fun", "/api/pickup-line", "Crypto/web3 themed pickup lines", "$0.001"),
+    ep("Fun", "/api/roast", "Get roasted by the blockchain (no wallet needed)", "$0.001"),
+    ep("Fun", "/api/roast-my-wallet/:address", "Roast someone's on-chain activity", "$0.002", [p("address", "Wallet address to roast")]),
+    ep("Fun", "/api/explain-like-im-5/:topic", "ELI5 any crypto concept", "$0.001", [p("topic", "Crypto topic to explain")]),
+    ep("Fun", "/api/rap-battle/:token1/:token2", "Rap battle between two tokens", "$0.003", [p("token1", "First token"), p("token2", "Second token")]),
+    ep("Fun", "/api/horoscope/:sign", "Crypto-themed daily horoscope", "$0.001", [p("sign", "Zodiac sign")]),
+    ep("Fun", "/api/name-my-token", "Generate creative token names", "$0.001"),
+    ep("Fun", "/api/write-whitepaper/:idea", "Generate a parody whitepaper", "$0.005", [p("idea", "Token/project idea")]),
+    ep("Fun", "/api/crypto-excuse", "Excuse for why you lost money in crypto", "$0.001"),
+    ep("Fun", "/api/crypto-haiku", "Generate a crypto-themed haiku", "$0.001"),
+    ep("Fun", "/api/shower-thought", "Crypto shower thoughts", "$0.001"),
+    ep("Fun", "/api/token-obituary/:token", "Write an obituary for a dead/dying token", "$0.002", [p("token", "Token name/symbol")]),
+    ep("Fun", "/api/wojak-moment", "Which Wojak are you today?", "$0.001"),
+    ep("Fun", "/api/vc-pitch/:idea", "Generate a VC pitch for any dumb idea", "$0.005", [p("idea", "Your startup idea")]),
+    ep("Fun", "/api/exit-strategy", "Generate a random crypto exit strategy", "$0.001"),
+    ep("Fun", "/api/fud-generator/:token", "Generate FUD about any token", "$0.001", [p("token", "Token to FUD")]),
+    ep("Fun", "/api/apology-letter/:token", "Write an apology to a token you paper-handed", "$0.002", [p("token", "Token you sold")]),
+    ep("Fun", "/api/blockchain-pickup/:chain", "Pickup lines for specific blockchains", "$0.001", [p("chain", "Blockchain name")]),
+    ep("Fun", "/api/degen-name", "Generate your degen alter ego name", "$0.001"),
+    ep("Fun", "/api/motivational-degen", "Motivational quotes for degens", "$0.001"),
+    ep("Fun", "/api/conspiracy/:topic", "Crypto conspiracy theories", "$0.002", [p("topic", "Conspiracy topic")]),
+    ep("Fun", "/api/crypto-insult", "Get roasted by the blockchain", "$0.001"),
+    ep("Fun", "/api/breakup-text/:token", "Write a breakup text to a token", "$0.002", [p("token", "Token to break up with")]),
+    ep("Fun", "/api/tweet-generator/:topic", "Generate a crypto Twitter banger", "$0.001", [p("topic", "Tweet topic")]),
+    ep("Fun", "/api/shill-generator/:token", "Generate a shill post for any token", "$0.002", [p("token", "Token to shill")]),
+    ep("Fun", "/api/panic-button", "Press the crypto panic button", "$0.001"),
+    ep("Fun", "/api/cope-post/:loss", "Generate a cope post for your losses", "$0.002", [p("loss", "Your loss amount/description")]),
+    ep("Fun", "/api/unpopular-opinion", "Unpopular crypto opinions", "$0.001"),
+    ep("Fun", "/api/acronym-generator/:letters", "Turn any letters into a crypto acronym", "$0.001", [p("letters", "Letters to acronymize")]),
+    ep("Fun", "/api/memecoin-generator", "Generate a complete memecoin concept", "$0.002"),
+    ep("Fun", "/api/defi-jargon-generator", "Generate fake but believable DeFi jargon", "$0.001"),
+    ep("Fun", "/api/ser-or-madam", "Are you a ser or a madam in crypto?", "$0.001"),
+    ep("Fun", "/api/one-liner", "Random crypto one-liner joke", "$0.001"),
+    // 🛠️ Tools
+    ep("Tools", "/api/gas-oracle", "Current gas prices across chains (simulated)", "$0.005"),
+    ep("Tools", "/api/token-lookup/:symbol", "Token info and stats (simulated)", "$0.005", [p("symbol", "Token symbol e.g. ETH")]),
+    ep("Tools", "/api/ens-whois/:name", "ENS name availability and info", "$0.005", [p("name", "ENS name e.g. vitalik.eth")]),
+    ep("Tools", "/api/contract-explain/:address", "Explain what a contract does (simulated)", "$0.01", [p("address", "Contract address")]),
+    ep("Tools", "/api/tx-decode/:hash", "Decode and explain a transaction (simulated)", "$0.008", [p("hash", "Transaction hash")]),
+    ep("Tools", "/api/portfolio-grade/:address", "Grade a wallet's portfolio (simulated)", "$0.01", [p("address", "Wallet address")]),
+    ep("Tools", "/api/airdrop-check/:address", "Check potential airdrop eligibility (simulated)", "$0.008", [p("address", "Wallet address")]),
+    ep("Tools", "/api/whale-alert", "Recent large transactions (simulated)", "$0.005"),
+    ep("Tools", "/api/wallet-age/:address", "Estimate wallet age and activity level", "$0.005", [p("address", "Wallet address")]),
+    ep("Tools", "/api/fee-calculator/:amount/:chain", "Calculate transaction fees for a transfer", "$0.005", [p("amount", "Transfer amount"), p("chain", "Blockchain")]),
+    ep("Tools", "/api/impermanent-loss/:change", "Calculate impermanent loss for a given price change", "$0.008", [p("change", "Price change percentage")]),
+    ep("Tools", "/api/unit-converter/:amount/:unit", "Convert between crypto units (wei, gwei, ETH, etc)", "$0.005", [p("amount", "Amount to convert"), p("unit", "Source unit")]),
+    ep("Tools", "/api/address-checksum/:address", "Validate and checksum an Ethereum address", "$0.005", [p("address", "Ethereum address")]),
+    ep("Tools", "/api/epoch-converter/:timestamp", "Convert between epoch and human-readable timestamps", "$0.005", [p("timestamp", "Epoch timestamp or date string")]),
+    ep("Tools", "/api/hex-converter/:value", "Convert between hex, decimal, and other formats", "$0.005", [p("value", "Value to convert")]),
+    ep("Tools", "/api/rate-my-portfolio/:holdings", "Rate your portfolio composition", "$0.01", [p("holdings", "Comma-separated token symbols")]),
+    ep("Tools", "/api/gas-worth-it/:amount/:chain", "Is it worth paying gas for this transaction?", "$0.005", [p("amount", "Transaction amount"), p("chain", "Blockchain")]),
+    ep("Tools", "/api/wallet-risk/:address", "Wallet risk score via Base RPC (live data)", "$0.008", [p("address", "Wallet address")]),
+    ep("Tools", "/api/ens-lookup/:name", "Resolve ENS name to Ethereum address (live)", "$0.008", [p("name", "ENS name")]),
+    ep("Tools", "/api/token-price/:symbol", "Live token price in USD from CoinGecko", "$0.005", [p("symbol", "Token symbol")]),
+    ep("Tools", "/api/trending-tokens", "Top trending tokens from CoinGecko (live)", "$0.008"),
+    ep("Tools", "/api/gas-compare", "Compare real-time gas costs across 10 chains in USD", "$0.01"),
+    ep("Tools", "/api/web-scrape", "Fetch and return readable content from any URL", "$0.01", [qp("url", "URL to scrape", true)]),
+    ep("Tools", "/api/news/crypto", "Latest crypto headlines from aggregated RSS feeds", "$0.005"),
+    ep("Tools", "/api/contract-info/:address", "Get contract name, verified status, ABI summary from Basescan", "$0.01", [p("address", "Contract address")]),
+    ep("Tools", "/api/weather", "Weather forecast for any location via Open-Meteo", "$0.002", [qp("lat", "Latitude", true), qp("lon", "Longitude", true)]),
+    ep("Tools", "/api/translate", "Translate text between languages via LibreTranslate", "$0.003", [qp("text", "Text to translate", true), qp("source", "Source language code", true), qp("target", "Target language code", true)]),
+    ep("Tools", "/api/dns/:domain", "DNS lookup — returns A, AAAA, MX, TXT records", "$0.001", [p("domain", "Domain name to look up")]),
+    // 📊 Analysis
+    ep("Analysis", "/api/market-mood", "Current crypto market sentiment analysis", "$0.02"),
+    ep("Analysis", "/api/alpha-report", "Daily alpha/opportunity report", "$0.05"),
+    ep("Analysis", "/api/compare/:token1/:token2", "Compare two tokens head-to-head", "$0.02", [p("token1", "First token"), p("token2", "Second token")]),
+    ep("Analysis", "/api/risk-score/:protocol", "DeFi protocol risk assessment", "$0.02", [p("protocol", "Protocol name")]),
+    ep("Analysis", "/api/meme-potential/:token", "Rate a token's meme potential", "$0.02", [p("token", "Token name/symbol")]),
+    ep("Analysis", "/api/yield-finder", "Find the best yield opportunities (simulated)", "$0.02"),
+    ep("Analysis", "/api/narrative-tracker", "Track hot crypto narratives", "$0.02"),
+    ep("Analysis", "/api/portfolio-builder/:amount", "Build a portfolio for a given budget", "$0.05", [p("amount", "Budget in USD")]),
+    ep("Analysis", "/api/chain-compare/:chain1/:chain2", "Compare two blockchains", "$0.02", [p("chain1", "First chain"), p("chain2", "Second chain")]),
+    ep("Analysis", "/api/defi-health-check", "Overall DeFi ecosystem health check", "$0.02"),
+    ep("Analysis", "/api/nft-roast/:collection", "Roast an NFT collection", "$0.02", [p("collection", "NFT collection name")]),
+    ep("Analysis", "/api/twitter-sentiment", "Twitter/X sentiment for a query via web search", "$0.02", [qp("q", "Search query", true)]),
+    ep("Analysis", "/api/defi-yields", "Top DeFi yields across protocols on Base via DeFiLlama", "$0.01"),
+    ep("Analysis", "/api/x402-recent-txns", "Real-time x402 transaction monitor on Base", "$0.05"),
+    // 🎲 Games
+    ep("Games", "/api/coin-flip", "Flip a blockchain-verified* coin", "$0.001"),
+    ep("Games", "/api/magic-8ball/:question", "Ask the crypto magic 8-ball", "$0.001", [p("question", "Your question")]),
+    ep("Games", "/api/would-you-rather", "Crypto 'Would You Rather' scenarios", "$0.001"),
+    ep("Games", "/api/two-truths-one-lie", "Two truths and a lie about crypto", "$0.001"),
+    ep("Games", "/api/this-or-that", "Quick crypto this-or-that preference poll", "$0.001"),
+    ep("Games", "/api/rekt-leaderboard", "Hall of fame for biggest crypto disasters", "$0.003"),
+    ep("Games", "/api/degen-dice", "Roll the degen dice", "$0.001"),
+    ep("Games", "/api/crypto-trivia", "Random crypto trivia question", "$0.001"),
+    ep("Games", "/api/crypto-achievement", "Unlock a random crypto achievement", "$0.001"),
+    // 🔮 Predictions
+    ep("Predictions", "/api/when-moon/:token", "Predict when a token will moon", "$0.003", [p("token", "Token name/symbol")]),
+    ep("Predictions", "/api/vibe-check", "Get the current crypto vibe check", "$0.002"),
+    ep("Predictions", "/api/bottom-signal", "Check if we've hit the bottom", "$0.003"),
+    ep("Predictions", "/api/top-signal", "Check if we've hit the top", "$0.003"),
+    ep("Predictions", "/api/zodiac-portfolio/:sign", "Portfolio allocation based on your zodiac sign", "$0.005", [p("sign", "Zodiac sign")]),
+    ep("Predictions", "/api/chain-fortune/:chain", "Fortune for a specific blockchain", "$0.002", [p("chain", "Blockchain name")]),
+    // 🏗️ Dev
+    ep("Dev", "/api/solidity-roast/:code", "Roast a Solidity function name", "$0.005", [p("code", "Solidity function name")]),
+    ep("Dev", "/api/smart-contract-idea", "Generate a random smart contract idea", "$0.005"),
+    ep("Dev", "/api/gas-golfing-tip", "Random Solidity gas optimization tip", "$0.005"),
+    ep("Dev", "/api/audit-bingo", "Generate an audit bingo card of common vulnerabilities", "$0.005"),
+    ep("Dev", "/api/dev-excuse", "Why the smart contract isn't deployed yet", "$0.003"),
+    // 🎪 Novelty
+    ep("Novelty", "/api/rate-my-address/:address", "Rate an Ethereum address's aesthetic appeal", "$0.002", [p("address", "Ethereum address")]),
+    ep("Novelty", "/api/blockchain-poem/:topic", "Generate a blockchain-themed poem", "$0.002", [p("topic", "Poem topic")]),
+    ep("Novelty", "/api/crypto-band-name", "Generate a crypto-themed band name", "$0.001"),
+    ep("Novelty", "/api/crypto-dating-profile", "Generate a crypto bro dating profile", "$0.002"),
+    ep("Novelty", "/api/what-if/:amount/:token/:date", "What if you'd invested X in Y on date Z?", "$0.003", [p("amount", "Investment amount"), p("token", "Token symbol"), p("date", "Date (YYYY-MM-DD)")]),
+    ep("Novelty", "/api/rename-my-nft/:name", "Get a better name for your NFT", "$0.001", [p("name", "Current NFT name")]),
+    ep("Novelty", "/api/blockchain-mad-libs", "Crypto-themed mad libs story", "$0.002"),
+    ep("Novelty", "/api/crypto-baby-name", "Name your baby after crypto", "$0.001"),
+    ep("Novelty", "/api/crypto-dream-interpreter/:dream", "Interpret your dream through a crypto lens", "$0.002", [p("dream", "Describe your dream")]),
+    ep("Novelty", "/api/wen-lambo/:portfolio_size", "Calculate when you can afford a Lambo", "$0.002", [p("portfolio_size", "Portfolio size in USD")]),
+    ep("Novelty", "/api/is-it-a-scam/:name", "Is this crypto project a scam? (satirical)", "$0.002", [p("name", "Project name")]),
+    ep("Novelty", "/api/how-early/:narrative", "How early are you to a crypto narrative?", "$0.002", [p("narrative", "Crypto narrative")]),
+    ep("Novelty", "/api/protocol-name-generator", "Generate a DeFi protocol name", "$0.001"),
+    ep("Novelty", "/api/wallet-personality/:address", "Determine your wallet's personality type", "$0.003", [p("address", "Wallet address")]),
+    ep("Novelty", "/api/timelock-message/:hours", "Get a motivational message locked to a future time", "$0.002", [p("hours", "Hours to lock")]),
+    // 💬 Social
+    ep("Social", "/api/discord-bio", "Generate a Discord bio for a crypto person", "$0.001"),
+    ep("Social", "/api/twitter-bio", "Generate a Crypto Twitter bio", "$0.001"),
+    ep("Social", "/api/gm", "Get a GM (Good Morning) message", "$0.001"),
+    ep("Social", "/api/gn", "Get a GN (Good Night) message", "$0.001"),
+    // 📦 Proprietary
+    ep("Proprietary", "/api/x402-stats", "Aggregated x402 ecosystem stats — EXCLUSIVE to httpay.xyz", "$0.05"),
+    ep("Proprietary", "/api/x402-services", "Complete directory of all known x402-enabled services", "$0.01"),
+    ep("Proprietary", "/api/erc8004-lookup/:agentId", "Look up ERC-8004 registered agent details from Base registry", "$0.01", [p("agentId", "Agent ID to look up")]),
+    // 📦 L2 Data
+    ep("L2 Data", "/api/l2-costs", "Real-time gas costs across 7 L2s in USD", "$0.05"),
+    ep("L2 Data", "/api/cheapest-chain/:operation", "Find cheapest L2 for an operation", "FREE", [p("operation", "Operation type: ethTransfer/erc20Transfer/nftMint/swap")]),
+    ep("L2 Data", "/api/gas/:chain", "Gas cost for a specific chain", "FREE", [p("chain", "Chain name: base/optimism/arbitrum/ethereum/zksync/linea/polygon-zkevm")]),
+];

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * httpay-mcp: MCP server exposing 121+ httpay.xyz crypto API endpoints as tools.
+ *
+ * Each endpoint is a paid API (via x402 protocol) that costs fractions of a cent.
+ * This MCP server lets any MCP-compatible client (Claude, Cursor, etc.) call them.
+ *
+ * Transport: stdio (standard for local MCP servers)
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+/**
+ * httpay-mcp: MCP server exposing 121+ httpay.xyz crypto API endpoints as tools.
+ *
+ * Each endpoint is a paid API (via x402 protocol) that costs fractions of a cent.
+ * This MCP server lets any MCP-compatible client (Claude, Cursor, etc.) call them.
+ *
+ * Transport: stdio (standard for local MCP servers)
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { ENDPOINTS } from "./endpoints.js";
+const BASE_URL = process.env.HTTPAY_BASE_URL || "https://httpay.xyz";
+/**
+ * Build the URL for an endpoint, substituting path params and appending query params.
+ */
+function buildUrl(endpoint, args) {
+    let path = endpoint.path;
+    // Substitute path params
+    for (const param of endpoint.params.filter((p) => p.in === "path")) {
+        path = path.replace(`:${param.name}`, encodeURIComponent(args[param.name] || ""));
+    }
+    // Build query string
+    const queryParams = endpoint.params.filter((p) => p.in === "query");
+    const queryParts = [];
+    for (const param of queryParams) {
+        if (args[param.name]) {
+            queryParts.push(`${param.name}=${encodeURIComponent(args[param.name])}`);
+        }
+    }
+    const url = `${BASE_URL}${path}`;
+    return queryParts.length > 0 ? `${url}?${queryParts.join("&")}` : url;
+}
+/**
+ * Call an httpay.xyz endpoint. These are x402-enabled — the server handles
+ * payment negotiation. For now we just make a simple GET request.
+ * Users can set HTTPAY_API_KEY env var if the server supports it.
+ */
+async function callEndpoint(endpoint, args) {
+    const url = buildUrl(endpoint, args);
+    const headers = {
+        Accept: "application/json",
+        "User-Agent": "httpay-mcp/0.1.0",
+    };
+    const apiKey = process.env.HTTPAY_API_KEY;
+    if (apiKey) {
+        headers["Authorization"] = `Bearer ${apiKey}`;
+    }
+    try {
+        const response = await fetch(url, { headers });
+        if (response.status === 402) {
+            // x402 payment required — return the payment details so the client can handle it
+            const paymentInfo = await response.text();
+            return JSON.stringify({
+                status: 402,
+                message: "Payment required (x402). This endpoint costs " + endpoint.price,
+                endpoint: url,
+                paymentInfo: paymentInfo.substring(0, 2000),
+            });
+        }
+        if (!response.ok) {
+            return JSON.stringify({
+                error: true,
+                status: response.status,
+                message: await response.text().catch(() => response.statusText),
+            });
+        }
+        const contentType = response.headers.get("content-type") || "";
+        if (contentType.includes("application/json")) {
+            const data = await response.json();
+            return JSON.stringify(data, null, 2);
+        }
+        return await response.text();
+    }
+    catch (error) {
+        return JSON.stringify({
+            error: true,
+            message: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+// Create the MCP server
+const server = new McpServer({
+    name: "httpay",
+    version: "0.1.0",
+});
+// Register every endpoint as an MCP tool
+for (const endpoint of ENDPOINTS) {
+    // Build Zod schema from params
+    const schemaShape = {};
+    for (const param of endpoint.params) {
+        const field = z.string().describe(param.description);
+        schemaShape[param.name] = param.required ? field : field.optional();
+    }
+    const description = [
+        endpoint.description,
+        `Category: ${endpoint.category}`,
+        `Price: ${endpoint.price}`,
+        `Endpoint: ${endpoint.method} ${endpoint.path}`,
+    ].join("\n");
+    server.tool(endpoint.name, description, schemaShape, async (args) => {
+        const result = await callEndpoint(endpoint, args);
+        return {
+            content: [{ type: "text", text: result }],
+        };
+    });
+}
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`httpay MCP server started with ${ENDPOINTS.length} tools`);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "httpay-mcp",
+  "version": "0.1.0",
+  "description": "MCP server exposing 121+ httpay.xyz crypto API endpoints as tools",
+  "author": "Alfred Zhang",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "httpay-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "tsx": "^4.0.0",
+    "@types/node": "^22.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "httpay",
+    "crypto",
+    "x402",
+    "api",
+    "model-context-protocol"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alfredz0x/httpay-mcp"
+  }
+}