oom-x402-mcp 1.0.0

package/mcp.js

@@ -0,0 +1,203 @@
+#!/usr/bin/env node
+
+const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
+const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
+const {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  ListResourcesRequestSchema,
+  ReadResourceRequestSchema,
+} = require('@modelcontextprotocol/sdk/types.js');
+const fs = require('fs');
+const path = require('path');
+
+// Load products-all.json at startup
+const productsPath = path.join(__dirname, 'products-all.json');
+let productsData = [];
+
+try {
+  const rawData = fs.readFileSync(productsPath, 'utf8');
+  productsData = JSON.parse(rawData);
+  console.error(`Loaded ${productsData.length} endpoints from products-all.json`);
+} catch (error) {
+  console.error(`Error loading products-all.json: ${error.message}`);
+  process.exit(1);
+}
+
+// Create MCP server
+const server = new Server(
+  {
+    name: 'x402-endpoint-catalog',
+    version: '1.0.0',
+  },
+  {
+    capabilities: {
+      tools: {},
+      resources: {},
+    },
+  }
+);
+
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      {
+        name: 'search_endpoints',
+        description: 'Search for API endpoints by query string. Searches across endpoint names, descriptions, and categories.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            query: {
+              type: 'string',
+              description: 'Search query to match against endpoint names, descriptions, and categories',
+            },
+          },
+          required: ['query'],
+        },
+      },
+      {
+        name: 'list_categories',
+        description: 'List all unique endpoint categories with their counts',
+        inputSchema: {
+          type: 'object',
+          properties: {},
+        },
+      },
+    ],
+  };
+});
+
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    if (name === 'search_endpoints') {
+      const { query } = args;
+      const searchQuery = query.toLowerCase();
+
+      // Search across name, description, and category
+      const results = productsData.filter((endpoint) => {
+        return (
+          endpoint.name?.toLowerCase().includes(searchQuery) ||
+          endpoint.description?.toLowerCase().includes(searchQuery) ||
+          endpoint.category?.toLowerCase().includes(searchQuery) ||
+          endpoint.id?.toLowerCase().includes(searchQuery)
+        );
+      });
+
+      return {
+        content: [
+          {
+            type: 'text',
+            text: JSON.stringify(
+              {
+                query,
+                count: results.length,
+                results: results.map((ep) => ({
+                  id: ep.id,
+                  name: ep.name,
+                  category: ep.category,
+                  price_usd: ep.price_usd,
+                  description: ep.description,
+                  route_path: ep.route_path,
+                  source_url: ep.source_url,
+                  response_fields: ep.response_fields,
+                })),
+              },
+              null,
+              2
+            ),
+          },
+        ],
+      };
+    } else if (name === 'list_categories') {
+      // Count endpoints per category
+      const categoryCounts = {};
+      productsData.forEach((endpoint) => {
+        const category = endpoint.category || 'uncategorized';
+        categoryCounts[category] = (categoryCounts[category] || 0) + 1;
+      });
+
+      // Convert to sorted array
+      const categories = Object.entries(categoryCounts)
+        .map(([category, count]) => ({ category, count }))
+        .sort((a, b) => b.count - a.count);
+
+      return {
+        content: [
+          {
+            type: 'text',
+            text: JSON.stringify(
+              {
+                total_categories: categories.length,
+                total_endpoints: productsData.length,
+                categories,
+              },
+              null,
+              2
+            ),
+          },
+        ],
+      };
+    } else {
+      throw new Error(`Unknown tool: ${name}`);
+    }
+  } catch (error) {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify({ error: error.message }),
+        },
+      ],
+      isError: true,
+    };
+  }
+});
+
+// List available resources
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+  return {
+    resources: [
+      {
+        uri: 'endpoint_catalog',
+        name: 'Endpoint Catalog',
+        description: 'Complete catalog of all available API endpoints with full details',
+        mimeType: 'application/json',
+      },
+    ],
+  };
+});
+
+// Handle resource reads
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+  const { uri } = request.params;
+
+  if (uri === 'endpoint_catalog') {
+    return {
+      contents: [
+        {
+          uri,
+          mimeType: 'application/json',
+          text: JSON.stringify(productsData, null, 2),
+        },
+      ],
+    };
+  } else {
+    throw new Error(`Unknown resource: ${uri}`);
+  }
+});
+
+// Start server with stdio transport
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error('x402 MCP server running on stdio');
+}
+
+main().catch((error) => {
+  console.error('Fatal error:', error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "oom-x402-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for the Orders of Magnitude x402 endpoint catalog — search 1,459 pay-per-call API endpoints",
+  "main": "mcp.js",
+  "bin": { "oom-x402-mcp": "mcp.js" },
+  "files": ["mcp.js", "products-all.json"],
+  "publishConfig": { "access": "public" },
+  "keywords": ["mcp", "model-context-protocol", "x402", "api-catalog", "agents"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "*"
+  }
+}