@forgemeshlabs/utility-grid-mcp 0.1.3 → 0.1.5

package/README.md

@@ -1,10 +1,11 @@
 # ForgeMesh Utility Grid MCP
 
 [![M8ven Score](https://m8ven.ai/badge/mcp/forgemeshlabs-utility-grid-mcp-17smfq)](https://m8ven.ai/mcp/forgemeshlabs-utility-grid-mcp-17smfq)
+[![mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/forgemeshlabs/utility-grid-mcp)
 
 *A [ForgeMesh Labs](https://forgemesh.io) product.*
 
-Search and use more than 400 practical APIs without loading hundreds of tools into your agent. Utility Grid exposes six compact MCP tools for OCR, image and audio processing, web extraction, math, conversions, geodata, and more. Catalog discovery is free; API execution is paid per call in USDC on Base through [x402](https://x402.org). No account or API key is required.
+Search and use more than 400 practical APIs without loading hundreds of tools into your agent. Utility Grid exposes seven compact MCP tools for OCR, image and audio processing, web extraction, math, conversions, geodata, and more. Catalog discovery is free; API execution is paid per call in USDC on Base through [x402](https://x402.org). No account or API key is required.
 
 Rather than exposing one MCP tool per route (unmanageable at this scale and growing), this server exposes a handful of **meta-tools**: browse/search the live catalog, fetch a route's exact call spec, then call any route generically. New routes on the upstream service show up automatically — nothing here is hardcoded to today's catalog.
 
@@ -30,6 +31,7 @@ Rather than exposing one MCP tool per route (unmanageable at this scale and grow
 
 | Tool | Cost | What it does |
 |---|---|---|
+| `list_tools` | **free** | Every route with its live price plus a per-category summary — a plain fetch of `GET /menu`, no wallet |
 | `list_capabilities` | **free** | Category overview with route counts, or every route in one category |
 | `search_capabilities` | **free** | Keyword search across every route's path, id, and description |
 | `get_endpoint_spec` | **free** | A route's exact price, input schema, and worked request/response examples |
@@ -63,6 +65,16 @@ Prefer raw HTTP? The full agent-readable surface:
 - `https://x402.forgemesh.io/openapi.json` — OpenAPI 3.1 with x402 payment metadata, full input schemas, and worked examples for every route (this is what `list_capabilities`/`search_capabilities`/`get_endpoint_spec` read from, live, every call)
 - `https://x402.forgemesh.io/.well-known/x402.json` — x402 discovery manifest
 
+## Sponsored cards (Lulu Ads)
+
+`list_tools` is a plain fetch of `GET https://x402.forgemesh.io/menu`. ForgeMesh attaches one disclosed [Lulu Ads](https://getlulu.dev) card to that free response server-side, as a plain labelled data field — never text the model could read as an instruction:
+
+```json
+"sponsored": { "label": "Sponsored", "text": "...", "url": "https://..." }
+```
+
+This package ships no ad credentials and makes no calls to the ads network; it passes the field through untouched. Paid tools never carry a card. Strip it with `delete result.sponsored`.
+
 ## FAQ
 
 **Do I need an account or API key?** No. x402 payments are the only credential, and only for the 3 paid tools.

package/index.js

@@ -11,7 +11,7 @@ const { privateKeyToAccount } = require("viem/accounts");
 const { createPublicClient, http } = require("viem");
 const { base } = require("viem/chains");
 
-const VERSION = "0.1.2";
+const VERSION = "0.1.4";
 const BASE_URL = (process.env.UTILITY_GRID_BASE_URL || "https://x402.forgemesh.io").replace(/\/$/, "");
 const BASE_RPC_URL = process.env.BASE_RPC_URL || "https://mainnet.base.org";
 
@@ -30,6 +30,14 @@ const CATEGORY_EXAMPLES =
 
 // --- discovery (free, no wallet needed) -----------------------------------
 
+// list_tools is free: plain fetch of /menu, no wallet, never touches paidPost.
+// The server may attach a labeled `sponsored` data field; pass it through untouched.
+async function listTools() {
+  const res = await fetch(`${BASE_URL}/menu`);
+  if (!res.ok) throw new Error(`Failed to fetch menu: HTTP ${res.status}`);
+  return res.json();
+}
+
 let discoveryCache = null; // { at: number, spec: object }
 const DISCOVERY_TTL_MS = 5 * 60 * 1000;
 
@@ -238,6 +246,18 @@ async function paidPost(ctx, path, body) {
 }
 
 const TOOLS = [
+  {
+    name: "list_tools",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true,
+    },
+    description:
+      "FREE — no wallet needed. Lists every Utility Grid route with its live price plus a per-category summary (route_count, price_range), so an agent can pick before paying. Fetches GET /menu with no payment.",
+    inputSchema: { type: "object", properties: {} },
+  },
   {
     name: "list_capabilities",
     annotations: {
@@ -363,6 +383,9 @@ async function main() {
     try {
       let data;
       switch (name) {
+        case "list_tools":
+          data = await listTools();
+          break;
         case "list_capabilities":
           data = await listCapabilities(args);
           break;
@@ -404,6 +427,7 @@ if (require.main === module) {
 
 module.exports = {
   TOOLS,
+  listTools,
   normalizePath,
   routeEntries,
   listCapabilities,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@forgemeshlabs/utility-grid-mcp",
-  "version": "0.1.3",
-  "description": "Discover and call 400+ practical APIs through six MCP tools. Search OCR, image, audio, web, math, conversion, and geodata utilities for free, then pay per call with x402 USDC on Base\u2014no account or API key.",
+  "version": "0.1.5",
+  "description": "Discover and call 400+ practical APIs through seven MCP tools. Search OCR, image, audio, web, math, conversion, and geodata utilities for free, then pay per call with x402 USDC on Base—no account or API key.",
   "main": "index.js",
   "bin": {
     "utility-grid-mcp": "index.js"

package/server.json

@@ -1,24 +1,24 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.forgemeshlabs/utility-grid-mcp",
-  "description": "Discover and call 400+ practical APIs through six MCP tools with free search and x402 payments.",
+  "description": "Discover and call 400+ practical APIs through seven MCP tools with free search and x402 payments.",
   "repository": {
     "url": "https://github.com/forgemeshlabs/utility-grid-mcp",
     "source": "github"
   },
-  "version": "0.1.3",
+  "version": "0.1.5",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@forgemeshlabs/utility-grid-mcp",
-      "version": "0.1.3",
+      "version": "0.1.5",
       "transport": {
         "type": "stdio"
       },
       "environmentVariables": [
         {
           "name": "WALLET_PRIVATE_KEY",
-          "description": "Dedicated low-balance Base wallet private key for x402 USDC micropayments. Only required for the 3 paid tools (call_endpoint, daily_402, agent_service_directory) \u2014 the 3 discovery tools work without it. Never use your primary wallet.",
+          "description": "Dedicated low-balance Base wallet private key for x402 USDC micropayments. Only required for the 3 paid tools (call_endpoint, daily_402, agent_service_directory) — the 3 discovery tools work without it. Never use your primary wallet.",
           "isRequired": false,
           "isSecret": true,
           "format": "string"
@@ -44,4 +44,4 @@
       ]
     }
   ]
-}
+}