@jmthomasofficial/x402-mcp-server 1.0.0

package/README.md

@@ -0,0 +1,70 @@
+# JMT x402 MCP Server
+
+25 pay-per-call API tools for AI agents, powered by the x402 protocol on Base mainnet.
+
+## What This Does
+
+This MCP server exposes 25 paid API endpoints as MCP tools. When an AI agent (Claude, Cursor, Cline) calls a tool, the request goes to our x402 server. The first request returns HTTP 402 (Payment Required). The agent's x402 client pays in USDC on Base mainnet and retries for the result.
+
+**No API keys. No signup. Payment IS the authentication.**
+
+## Tools
+
+| Tool | Price | Description |
+|------|-------|-------------|
+| ai_answer | $0.03 | AI-powered search answer with citations |
+| company_intel | $0.10 | Company intelligence dossier with SWOT analysis |
+| sec_filing_analyzer | $0.08 | SEC 10-K/10-Q analysis with risk extraction |
+| news_briefing | $0.05 | Multi-source news briefing with LLM summary |
+| social_sentiment | $0.05 | Cross-platform social sentiment analysis |
+| macro_dashboard | $0.04 | Macro economic dashboard with LLM commentary |
+| market_pulse | $0.04 | Stock market pulse with analyst sentiment |
+| crypto_research | $0.05 | Crypto research brief with on-chain analysis |
+| competitor_analysis | $0.08 | Competitor comparison matrix |
+| domain_trust_score | $0.04 | Domain trust score 0-100 with risk factors |
+| regulatory_monitor | $0.06 | Regulatory filing monitor with impact analysis |
+| web_search | $0.02 | Web search via SearXNG |
+| url_extract | $0.02 | Extract clean text from any URL |
+| summarize | $0.05 | AI-powered text summary |
+| analyze | $0.10 | Deep AI analysis with web research |
+| deep_research | $0.15 | Deep research report with sources |
+| crypto_price | $0.03 | Live crypto price lookup |
+| stock_quote | $0.03 | Live stock quote |
+| gas_snapshot | $0.002 | Live Base gas snapshot |
+| treasury_yields | $0.03 | US Treasury yield curve |
+| whois | $0.01 | WHOIS/RDAP domain lookup |
+| edgar_lookup | $0.01 | SEC EDGAR company lookup |
+| hash | $0.001 | Hash text (SHA-256, SHA-512, MD5) |
+| json_to_csv | $0.002 | Convert JSON array to CSV |
+| text_diff | $0.002 | Compare two text strings |
+
+## Payment Setup
+
+- **Protocol:** x402 v1
+- **Network:** Base mainnet (eip155:8453)
+- **Currency:** USDC (Bridged USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
+- **Facilitator:** Dexter (x402.dexter.cash) — 0% fee, gas-sponsored for buyers
+- **Pay-to wallet:** 0x624FaF18C78456C8Da5bf156Cd77c1A2033F21c5
+
+To make paid calls, install an x402 client:
+```bash
+npm install @x402/fetch @x402/evm
+```
+
+## Installation
+
+```bash
+npm install
+npm start
+```
+
+## Discovery
+
+- OpenAPI: https://jmt-x402-proxy.jmthomasofficial.workers.dev/openapi.json
+- Manifest: https://jmt-x402-proxy.jmthomasofficial.workers.dev/.well-known/x402
+- LLMs.txt: https://jmt-x402-proxy.jmthomasofficial.workers.dev/llms.txt
+- Pricing: https://jmt-x402-proxy.jmthomasofficial.workers.dev/api/pricing
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@jmthomasofficial/x402-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server wrapping 25 x402 pay-per-call API endpoints on Base mainnet. AI agents can discover and call paid APIs for company intelligence, SEC filing analysis, news briefings, social sentiment, crypto research, and more.",
+  "main": "src/index.js",
+  "bin": {
+    "x402-mcp-server": "src/index.js"
+  },
+  "scripts": {
+    "start": "node src/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  },
+  "keywords": [
+    "x402",
+    "mcp",
+    "base",
+    "usdc",
+    "ai-agents",
+    "paid-api"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jmthomasofficial/x402-mcp-server.git"
+  },
+  "mcpName": "io.github.jmthomasofficial/x402-agent-tools"
+}

package/src/index.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+/**
+ * JMT x402 MCP Server
+ * 
+ * Wraps 25 x402 pay-per-call API endpoints on Base mainnet as MCP tools.
+ * Each tool call goes to https://jmt-x402-proxy.jmthomasofficial.workers.dev/api/<endpoint>
+ * The x402 protocol handles payment automatically — the first request returns HTTP 402,
+ * the MCP client pays in USDC on Base, and retries for the result.
+ * 
+ * No API key needed. Payment IS the authentication.
+ */
+
+const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
+const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
+const {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} = require("@modelcontextprotocol/sdk/types.js");
+
+const BASE_URL = "https://jmt-x402-proxy.jmthomasofficial.workers.dev";
+
+// All 25 x402 paid endpoints
+const ENDPOINTS = [
+  { name: "ai_answer", method: "GET", path: "/api/answer", price: "$0.03", desc: "AI-powered search answer with citations. SearXNG + local LLM.", params: [{ name: "q", type: "string", required: true, desc: "Question to answer" }] },
+  { name: "company_intel", method: "POST", path: "/api/company-intel", price: "$0.10", desc: "Company intelligence dossier — SEC filings + web research + LLM SWOT analysis.", params: [{ name: "company", type: "string", required: true, desc: "Company name or ticker" }] },
+  { name: "sec_filing_analyzer", method: "POST", path: "/api/sec-filing-analyzer", price: "$0.08", desc: "Deep SEC filing analysis — 10-K/10-Q with LLM risk extraction.", params: [{ name: "ticker", type: "string", required: true, desc: "Stock ticker" }, { name: "filing_type", type: "string", required: false, desc: "Filing type (10-K, 10-Q, 8-K)" }] },
+  { name: "news_briefing", method: "POST", path: "/api/news-briefing", price: "$0.05", desc: "AI news briefing — multi-source search + LLM summary with sentiment.", params: [{ name: "topic", type: "string", required: true, desc: "Topic to brief on" }] },
+  { name: "social_sentiment", method: "POST", path: "/api/social-sentiment", price: "$0.05", desc: "Cross-platform social sentiment analysis with LLM.", params: [{ name: "topic", type: "string", required: true, desc: "Topic to analyze" }] },
+  { name: "macro_dashboard", method: "POST", path: "/api/macro-dashboard", price: "$0.04", desc: "Macro economic dashboard — Treasury yields + CPI + Fed + LLM commentary.", params: [{ name: "region", type: "string", required: false, desc: "Region (default: US)" }] },
+  { name: "market_pulse", method: "POST", path: "/api/market-pulse", price: "$0.04", desc: "Stock market pulse — quote + news + analyst sentiment + LLM.", params: [{ name: "ticker", type: "string", required: false, desc: "Stock ticker (default: AAPL)" }] },
+  { name: "crypto_research", method: "POST", path: "/api/crypto-research", price: "$0.05", desc: "Crypto research brief — price + on-chain + news + LLM analysis.", params: [{ name: "coin", type: "string", required: false, desc: "Coin name/id (default: bitcoin)" }] },
+  { name: "competitor_analysis", method: "POST", path: "/api/competitor-analysis", price: "$0.08", desc: "Competitor analysis — comparison matrix with LLM.", params: [{ name: "company", type: "string", required: true, desc: "Company name" }] },
+  { name: "domain_trust_score", method: "POST", path: "/api/domain-trust-score", price: "$0.04", desc: "Domain trust score — WHOIS + SSL + DNS + LLM 0-100 score.", params: [{ name: "domain", type: "string", required: true, desc: "Domain to assess" }] },
+  { name: "regulatory_monitor", method: "POST", path: "/api/regulatory-monitor", price: "$0.06", desc: "Regulatory filing monitor — government sites + LLM impact analysis.", params: [{ name: "topic", type: "string", required: true, desc: "Topic to monitor" }] },
+  { name: "web_search", method: "GET", path: "/api/search", price: "$0.02", desc: "Web search via SearXNG.", params: [{ name: "q", type: "string", required: true, desc: "Search query" }] },
+  { name: "url_extract", method: "POST", path: "/api/extract", price: "$0.02", desc: "Extract clean text from any URL.", params: [{ name: "url", type: "string", required: true, desc: "URL to extract" }] },
+  { name: "summarize", method: "POST", path: "/api/summarize", price: "$0.05", desc: "AI-powered text summary via local LLM.", params: [{ name: "text", type: "string", required: true, desc: "Text to summarize" }] },
+  { name: "analyze", method: "POST", path: "/api/analyze", price: "$0.10", desc: "Deep AI analysis with web research.", params: [{ name: "topic", type: "string", required: true, desc: "Topic to analyze" }] },
+  { name: "deep_research", method: "POST", path: "/api/research", price: "$0.15", desc: "Deep research report with sources.", params: [{ name: "topic", type: "string", required: true, desc: "Research topic" }] },
+  { name: "crypto_price", method: "GET", path: "/api/crypto-price", price: "$0.03", desc: "Live crypto price lookup.", params: [{ name: "id", type: "string", required: false, desc: "Coin ID (default: bitcoin)" }] },
+  { name: "stock_quote", method: "GET", path: "/api/stock-quote", price: "$0.03", desc: "Live stock quote.", params: [{ name: "symbol", type: "string", required: false, desc: "Ticker (default: AAPL)" }] },
+  { name: "gas_snapshot", method: "GET", path: "/api/gas-snapshot", price: "$0.002", desc: "Live Base gas snapshot.", params: [] },
+  { name: "treasury_yields", method: "GET", path: "/api/treasury-yield-curve", price: "$0.03", desc: "US Treasury yield curve.", params: [] },
+  { name: "whois", method: "GET", path: "/api/whois", price: "$0.01", desc: "WHOIS/RDAP domain lookup.", params: [{ name: "domain", type: "string", required: true, desc: "Domain to lookup" }] },
+  { name: "edgar_lookup", method: "GET", path: "/api/edgar-company-lookup", price: "$0.01", desc: "SEC EDGAR company lookup.", params: [{ name: "ticker", type: "string", required: false, desc: "Ticker (default: AAPL)" }] },
+  { name: "hash", method: "POST", path: "/api/hash", price: "$0.001", desc: "Hash text (SHA-256, SHA-512, MD5).", params: [{ name: "text", type: "string", required: true, desc: "Text to hash" }, { name: "algo", type: "string", required: false, desc: "Algorithm (default: sha256)" }] },
+  { name: "json_to_csv", method: "POST", path: "/api/json-to-csv", price: "$0.002", desc: "Convert JSON array to CSV.", params: [{ name: "data", type: "array", required: true, desc: "JSON array to convert" }] },
+  { name: "text_diff", method: "POST", path: "/api/text-diff", price: "$0.002", desc: "Compare two text strings.", params: [{ name: "text1", type: "string", required: true, desc: "First text" }, { name: "text2", type: "string", required: true, desc: "Second text" }] },
+];
+
+const server = new Server(
+  { name: "jmt-x402-agent-tools", version: "1.0.0" },
+  { capabilities: { tools: {} } }
+);
+
+// List tools
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: ENDPOINTS.map((ep) => ({
+    name: ep.name,
+    description: `${ep.desc} Price: ${ep.price}/call via x402 (USDC on Base mainnet).`,
+    inputSchema: {
+      type: "object",
+      properties: Object.fromEntries(
+        ep.params.map((p) => [p.name, { type: p.type, description: p.desc }])
+      ),
+      required: ep.params.filter((p) => p.required).map((p) => p.name),
+    },
+  })),
+}));
+
+// Call tool
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  const ep = ENDPOINTS.find((e) => e.name === name);
+  if (!ep) {
+    return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
+  }
+
+  const url = ep.method === "GET"
+    ? `${BASE_URL}${ep.path}?${new URLSearchParams(args || {}).toString()}`
+    : `${BASE_URL}${ep.path}`;
+
+  const options = ep.method === "POST"
+    ? { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(args || {}) }
+    : { method: "GET", headers: { Accept: "application/json" } };
+
+  try {
+    const res = await fetch(url, options);
+    
+    // If 402, return payment instructions
+    if (res.status === 402) {
+      const body = await res.json();
+      return {
+        content: [{
+          type: "text",
+          text: `Payment required (HTTP 402). This endpoint costs ${ep.price} via x402 protocol.\n\nTo pay: use an x402 client (e.g., @x402/fetch) with a funded Base mainnet wallet.\nPayment details:\n${JSON.stringify(body, null, 2)}`
+        }],
+        isError: true,
+      };
+    }
+
+    const data = await res.json();
+    return {
+      content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+  } catch (e) {
+    return {
+      content: [{ type: "text", text: `Error calling ${name}: ${e.message}` }],
+      isError: true,
+    };
+  }
+});
+
+// Start server
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("JMT x402 MCP Server running (25 tools, Base mainnet, Dexter facilitator)");
+}
+
+main().catch(console.error);