rwagenthub-mcp 1.0.0

package/README.md

@@ -0,0 +1,87 @@
+# agenthub-mcp
+
+MCP server for [AgentHub](https://agents-production-73c1.up.railway.app) — gives any MCP-compatible AI client access to 19 APIs (flights, hotels, weather, crypto, DeFi, web search, code execution, and more) paid automatically via [x402](https://x402.org) USDC micropayments on Base.
+
+## Requirements
+
+- Node.js >= 22
+- A Base wallet with a small USDC balance (most APIs cost $0.01–$0.06 per call)
+
+## Setup
+
+### 1. Get a wallet private key
+
+Create a dedicated wallet on Base Mainnet and fund it with a few USDC. You can use [Coinbase Wallet](https://wallet.coinbase.com) or any EVM wallet.
+
+> Use a **dedicated wallet** with a small balance — not your main wallet.
+
+### 2. Add to your MCP client config
+
+**Claude Desktop** — edit `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "agenthub": {
+      "command": "npx",
+      "args": ["-y", "agenthub-mcp"],
+      "env": {
+        "MCP_WALLET_PRIVATE_KEY": "0x..."
+      }
+    }
+  }
+}
+```
+
+**Cursor / Cline / Windsurf** — same config format, check your client's MCP settings.
+
+### 3. Restart your client
+
+The server fetches the latest API list from the gateway on startup — no manual updates needed.
+
+## Available tools
+
+| Tool | Description | Price |
+|------|-------------|-------|
+| `flight_search` | Search flights between airports (Duffel) | $0.01 |
+| `flight_status` | Get flight status by carrier + number | $0.01 |
+| `seat_map` | Seat map for a Duffel offer | $0.01 |
+| `airport_search` | List airports by country | $0.01 |
+| `hotel_search` | Search hotels in a city (Amadeus) | $0.06 |
+| `activities_search` | Tours and activities near a location | $0.01 |
+| `web_search` | Google search results (Serper) | $0.02 |
+| `web_search_ai` | AI-powered search with summaries (LangSearch) | $0.02 |
+| `places_search` | Places and businesses via Google Maps data | $0.02 |
+| `image_search` | Image search | $0.01 |
+| `shopping_search` | Product search across online stores | $0.02 |
+| `weather_forecast` | Current + 15-day forecast (Visual Crossing) | $0.01 |
+| `url_extract` | Extract text content from any URL | $0.02 |
+| `exchange_rate` | Currency exchange rates (ECB/Frankfurter) | $0.01 |
+| `crypto_price` | Crypto prices and 24h change | $0.01 |
+| `defi_market_snapshot` | DeFi TVL, top protocols, DEX volume (DeFiLlama) | $0.02 |
+| `defi_yields` | Best yield farming pools (DeFiLlama) | $0.02 |
+| `code_exec` | Execute code in an isolated sandbox (e2b) | $0.05 |
+| `email_send` | Send transactional email (Resend) | $0.01 |
+
+Prices are in USDC and charged per call via x402 on Base Mainnet.
+
+## How it works
+
+```
+Your MCP client (Claude Desktop, Cursor, etc.)
+        │  stdio
+        ▼
+  agenthub-mcp  (this package)
+        │  POST /v1/call + x402 auto-payment
+        ▼
+  AgentHub Gateway (Railway)
+        │
+        ▼
+  Flights · Hotels · Weather · Crypto · DeFi · Search · ...
+```
+
+On startup, the server fetches the live API schema from the gateway — so new APIs and price changes are reflected automatically without updating the package.
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createWalletClient, http } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { base } from "viem/chains";
+import { wrapFetchWithPayment } from "@x402/fetch";
+import { x402Client } from "@x402/core/client";
+import { registerExactEvmScheme } from "@x402/evm/exact/client";
+import { z } from "zod";
+
+const GATEWAY_URL = "https://agents-production-73c1.up.railway.app";
+
+// ── Payment setup ──────────────────────────────────────────────────────────────
+if (!process.env.MCP_WALLET_PRIVATE_KEY) {
+  console.error("[mcp] ERROR: MCP_WALLET_PRIVATE_KEY not set");
+  console.error("[mcp] Add it to your MCP client config under env.MCP_WALLET_PRIVATE_KEY");
+  process.exit(1);
+}
+
+const account = privateKeyToAccount(process.env.MCP_WALLET_PRIVATE_KEY);
+const walletClient = createWalletClient({ account, chain: base, transport: http() });
+const signer = Object.assign(walletClient, { address: account.address });
+
+const client = new x402Client();
+registerExactEvmScheme(client, { signer });
+const pay = wrapFetchWithPayment(fetch, client);
+
+async function callGateway(api, inputs) {
+  const res = await pay(`${GATEWAY_URL}/v1/call`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ api, inputs }),
+  });
+  return res.json();
+}
+
+// ── Type mapper: gateway field types → Zod ────────────────────────────────────
+function toZod(field) {
+  let schema;
+  if (field.type === "number") {
+    schema = z.number();
+  } else if (field.type === "boolean") {
+    schema = z.boolean();
+  } else if (field.type === "string|string[]") {
+    schema = z.union([z.string(), z.array(z.string())]);
+  } else {
+    schema = z.string();
+  }
+
+  if (field.description) schema = schema.describe(field.description);
+  if (!field.required) schema = schema.optional();
+  if (field.default !== undefined) schema = schema.default(field.default);
+  return schema;
+}
+
+// ── Main: fetch schema from gateway, register tools, start server ──────────────
+async function main() {
+  // Fetch live schema + prices from the gateway
+  const res = await fetch(`${GATEWAY_URL}/v1/schema`);
+  if (!res.ok) {
+    console.error(`[mcp] Failed to fetch schema from gateway: ${res.status} ${res.statusText}`);
+    process.exit(1);
+  }
+  const { apis } = await res.json();
+
+  const server = new McpServer({ name: "agenthub", version: "1.0.0" });
+
+  for (const api of apis) {
+    const zodShape = {};
+    for (const [fieldName, field] of Object.entries(api.inputs)) {
+      zodShape[fieldName] = toZod(field);
+    }
+
+    server.tool(
+      api.name,
+      `${api.description} Costs $${(api.price_usd ?? 0.01).toFixed(2)} USDC per call via x402 on Base.`,
+      zodShape,
+      async (inputs) => {
+        try {
+          const result = await callGateway(api.name, inputs);
+
+          if (!result.success) {
+            return {
+              content: [{ type: "text", text: `Error: ${result.error}${result.message ? ` — ${result.message}` : ""}${result.hint ? `\n${result.hint}` : ""}` }],
+              isError: true,
+            };
+          }
+
+          return {
+            content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }],
+          };
+        } catch (err) {
+          return {
+            content: [{ type: "text", text: `Gateway error: ${err.message}` }],
+            isError: true,
+          };
+        }
+      }
+    );
+  }
+
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error(`[mcp] AgentHub MCP server running — ${apis.length} tools available`);
+}
+
+main().catch((err) => {
+  console.error("[mcp] Fatal:", err);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "rwagenthub-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for AgentHub — 19 AI APIs (flights, weather, crypto, search, DeFi, code execution...) paid via x402 USDC on Base",
+  "type": "module",
+  "bin": {
+    "rwagenthub-mcp": "./index.js"
+  },
+  "files": [
+    "index.js"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "agents",
+    "x402",
+    "crypto",
+    "flights",
+    "weather",
+    "defi",
+    "base"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@x402/core": "^2.3.1",
+    "@x402/evm": "^2.3.1",
+    "@x402/fetch": "^2.3.0",
+    "dotenv": "^16.4.0",
+    "viem": "^2.46.2",
+    "zod": "^3.25.76"
+  }
+}