mcp-server-agentpay 1.0.0

package/README.md

@@ -0,0 +1,60 @@
+# mcp-server-agentpay
+
+MCP server for **AgentPay** — the payment gateway for autonomous AI agents.
+
+Fund a wallet once, give your agent the key, and it discovers, provisions, and pays for tool APIs on its own.
+
+## Quick Setup
+
+```bash
+# Add to Claude Code
+claude mcp add agentpay -- npx mcp-server-agentpay
+
+# Set your gateway key
+export AGENTPAY_GATEWAY_KEY="apg_your_key_here"
+```
+
+## Get a Gateway Key
+
+```bash
+curl -X POST https://agentpay.metaltorque.dev/gateway/register \
+  -H "Content-Type: application/json" \
+  -d '{"email": "you@example.com"}'
+```
+
+You get $1 in free credits to start.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_tools` | List all available tools with pricing |
+| `discover_tools` | Search tools by keyword/capability |
+| `call_tool` | Call any tool method (auto-provisions, metered) |
+| `check_balance` | Check wallet balance and provisioned tools |
+| `provision_tool` | Pre-provision access to a tool |
+| `get_usage` | View recent call history and costs |
+| `fund_wallet` | Get Stripe checkout URL to add credits |
+
+## How It Works
+
+1. **Register** — create a wallet, get a gateway key
+2. **Fund** — add credits via Stripe ($10–$600 packages)
+3. **Discover** — agent searches for tools by capability
+4. **Call** — agent calls any tool, gateway handles auth + billing
+
+The agent never needs to know about individual tool APIs, accounts, or payment. One key, every tool.
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `AGENTPAY_GATEWAY_KEY` | Yes | Your gateway API key (starts with `apg_`) |
+| `AGENTPAY_URL` | No | Custom gateway URL (default: `https://agentpay.metaltorque.dev`) |
+
+## Available Tools (via gateway)
+
+- **Security Audit** — scan websites for vulnerabilities, SSL issues, OWASP risks
+- **IndexForge SEO** — submit URLs to Google/Bing, scan sitemaps, check index status
+
+More tools added regularly. Tool providers can register at the gateway.

package/index.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env node
+
+const { McpServer } = require("@modelcontextprotocol/sdk/server/mcp.js");
+const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
+const { z } = require("zod");
+const https = require("https");
+const http = require("http");
+
+// ── Config ──────────────────────────────────────────────────────────
+
+const GATEWAY_KEY = process.env.AGENTPAY_GATEWAY_KEY || "";
+const BASE_URL = (process.env.AGENTPAY_URL || "https://agentpay.metaltorque.dev").replace(/\/$/, "");
+
+// ── HTTP helper ─────────────────────────────────────────────────────
+
+function request(method, urlPath, body, timeout = 120_000) {
+  return new Promise((resolve, reject) => {
+    const fullUrl = `${BASE_URL}${urlPath}`;
+    const mod = fullUrl.startsWith("https") ? https : http;
+    const parsed = new URL(fullUrl);
+
+    const headers = {
+      "Content-Type": "application/json",
+      "User-Agent": "mcp-server-agentpay/1.0.0",
+    };
+    if (GATEWAY_KEY) headers["X-Gateway-Key"] = GATEWAY_KEY;
+
+    const opts = {
+      hostname: parsed.hostname,
+      port: parsed.port || (parsed.protocol === "https:" ? 443 : 80),
+      path: parsed.pathname + parsed.search,
+      method,
+      headers,
+      timeout,
+    };
+
+    const req = mod.request(opts, (res) => {
+      let data = "";
+      res.on("data", (c) => (data += c));
+      res.on("end", () => {
+        try {
+          const json = JSON.parse(data);
+          if (res.statusCode >= 400) return reject(new Error(json.error || `HTTP ${res.statusCode}`));
+          resolve(json);
+        } catch {
+          if (res.statusCode >= 400) return reject(new Error(`HTTP ${res.statusCode}: ${data.slice(0, 300)}`));
+          resolve(data);
+        }
+      });
+    });
+
+    req.on("error", reject);
+    req.on("timeout", () => { req.destroy(); reject(new Error("Request timed out")); });
+    if (body) req.write(JSON.stringify(body));
+    req.end();
+  });
+}
+
+function noKeyError() {
+  return {
+    content: [{ type: "text", text: "Error: AGENTPAY_GATEWAY_KEY environment variable is required.\n\nRegister at https://agentpay.metaltorque.dev to get a gateway key.\nYou get $1 in free credits to start." }],
+  };
+}
+
+// ── MCP Server ──────────────────────────────────────────────────────
+
+const server = new McpServer({
+  name: "agentpay",
+  version: "1.0.0",
+});
+
+// ── Tool: discover_tools ────────────────────────────────────────────
+
+server.tool(
+  "discover_tools",
+  "Search for available AI tools by keyword or capability. Returns matching tools with descriptions, methods, and per-call pricing. Use this to find what tools are available before calling them.",
+  {
+    query: z.string().describe("Search keyword (e.g. 'security', 'seo', 'indexing', 'vulnerability')"),
+  },
+  async ({ query }) => {
+    try {
+      const result = await request("POST", "/gateway/discover", { query });
+      if (result.count === 0) {
+        return { content: [{ type: "text", text: `No tools found for "${query}". Try: security, seo, indexing, vulnerability, audit` }] };
+      }
+      return { content: [{ type: "text", text: JSON.stringify(result.tools, null, 2) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: list_tools ────────────────────────────────────────────────
+
+server.tool(
+  "list_tools",
+  "List all available tools in the AgentPay gateway with their descriptions, methods, and pricing. No authentication required.",
+  {},
+  async () => {
+    try {
+      const result = await request("GET", "/gateway/tools");
+      return { content: [{ type: "text", text: JSON.stringify(result.tools, null, 2) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: check_balance ─────────────────────────────────────────────
+
+server.tool(
+  "check_balance",
+  "Check your AgentPay wallet balance, total credits funded, total spent, and which tools you have provisioned access to.",
+  {},
+  async () => {
+    if (!GATEWAY_KEY) return noKeyError();
+    try {
+      const result = await request("GET", "/gateway/balance");
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: call_tool ─────────────────────────────────────────────────
+
+server.tool(
+  "call_tool",
+  "Call any tool method through the AgentPay gateway. Automatically provisions access on first use. Credits are deducted per call. Use discover_tools or list_tools first to see available tools and methods.",
+  {
+    tool: z.string().describe("Tool ID (e.g. 'agent-audit', 'indexforge')"),
+    method: z.string().describe("Method name (e.g. 'security_scan', 'scan_sitemap')"),
+    params_json: z.string().optional().describe("Method parameters as JSON string (e.g. '{\"url\": \"example.com\"}'). Omit if no params needed."),
+  },
+  async ({ tool, method, params_json }) => {
+    if (!GATEWAY_KEY) return noKeyError();
+    try {
+      let params = {};
+      if (params_json) {
+        try { params = JSON.parse(params_json); } catch { return { content: [{ type: "text", text: "Error: params_json must be valid JSON" }] }; }
+      }
+      const result = await request("POST", "/gateway/call", { tool, method, params }, 600_000);
+      const meta = `[Cost: $${(result.cost || 0).toFixed(2)} | Balance: $${(result.balance || 0).toFixed(2)} | Time: ${result.elapsed || 0}ms]`;
+      return {
+        content: [{ type: "text", text: `${meta}\n\n${JSON.stringify(result.result, null, 2)}` }],
+      };
+    } catch (e) {
+      return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: provision_tool ────────────────────────────────────────────
+
+server.tool(
+  "provision_tool",
+  "Pre-provision access to a specific tool. This auto-creates an account on the tool's backend. Not required — call_tool auto-provisions on first use — but useful to confirm access before making calls.",
+  {
+    tool: z.string().describe("Tool ID to provision (e.g. 'indexforge', 'agent-audit')"),
+  },
+  async ({ tool }) => {
+    if (!GATEWAY_KEY) return noKeyError();
+    try {
+      const result = await request("POST", "/gateway/provision", { tool });
+      return { content: [{ type: "text", text: `${result.status}: ${result.message}` }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: get_usage ─────────────────────────────────────────────────
+
+server.tool(
+  "get_usage",
+  "View your recent tool call history — which tools you called, what methods, how much each cost, and when.",
+  {
+    limit: z.number().default(20).describe("Number of recent calls to show (default: 20, max: 200)"),
+  },
+  async ({ limit }) => {
+    if (!GATEWAY_KEY) return noKeyError();
+    try {
+      const result = await request("GET", `/gateway/usage?limit=${limit}`);
+      return { content: [{ type: "text", text: JSON.stringify(result.usage, null, 2) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: fund_wallet ───────────────────────────────────────────────
+
+server.tool(
+  "fund_wallet",
+  "Get a Stripe checkout URL to add credits to your wallet. Returns a link that a human can open to complete payment. Credits are added instantly after payment.",
+  {
+    package: z.enum(["micro", "small", "medium", "large", "whale"]).describe("Credit package: micro ($10/10cr), small ($45/50cr), medium ($80/100cr), large ($350/500cr), whale ($600/1000cr)"),
+  },
+  async ({ package: pkg }) => {
+    if (!GATEWAY_KEY) return noKeyError();
+    try {
+      const result = await request("POST", "/gateway/fund", { package: pkg });
+      return { content: [{ type: "text", text: `Checkout URL (share with a human to complete payment):\n${result.checkoutUrl}\n\nPackage: ${pkg} (${result.credits} credits)` }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Start ───────────────────────────────────────────────────────────
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((e) => {
+  console.error("MCP server error:", e);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "mcp-server-agentpay",
+  "version": "1.0.0",
+  "description": "MCP server for AgentPay — the payment gateway for autonomous AI agents. Lets agents discover, provision, and pay for MCP tool APIs with a single gateway key.",
+  "bin": {
+    "mcp-server-agentpay": "index.js"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "agent-payment",
+    "agent-wallet",
+    "agent-gateway",
+    "payment-gateway",
+    "ai-agent",
+    "ai-tools",
+    "autonomous-agent",
+    "tool-discovery",
+    "tool-marketplace",
+    "api-marketplace",
+    "metered-billing",
+    "pay-per-use",
+    "claude",
+    "claude-code",
+    "llm",
+    "llm-tools",
+    "chatgpt",
+    "openai",
+    "agent-economy",
+    "machine-to-machine",
+    "api-credits"
+  ],
+  "license": "MIT",
+  "author": "MetalTorque",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/joepangallo/agent-pay"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "index.js",
+    "README.md"
+  ]
+}