subgraph-registry-mcp 0.9.2 → 0.9.3

package/data/openapi.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "Subgraph Registry",
     "description": "Agent-friendly subgraph discovery on The Graph Network. 14,700+ classified subgraphs with semantic search, reliability scoring, schema-evolution tracking, and x402 query URLs ($0.01 USDC on Base, no API key).",
-    "version": "0.8.31",
+    "version": "0.9.3",
     "license": {
       "name": "MIT"
     },
@@ -23,7 +23,7 @@
       "post": {
         "operationId": "tool_search_subgraphs",
         "summary": "Search and filter the classified subgraph registry (15,500+ subgraphs).",
-        "description": "Search and filter the classified subgraph registry (15,500+ subgraphs). Filter by domain (defi, nfts, dao, gaming, identity, infrastructure, social, analytics), network (mainnet, arbitrum-one, base, matic, bsc, optimism, avalanche), protocol_type (dex, lending, bridge, staking, options, perpetuals, nft-marketplace, yield-aggregator, governance, name-service), canonical entity type (liquidity_pool, trade, token, position, vault, loan, collateral, liquidation, nft_collection, nft_item, nft_sale, proposal, delegate, domain_name, account, transaction, daily_snapshot, hourly_snapshot), or free-text keyword. Returns subgraphs ranked by reliability score. Each result includes query_url_x402 (POST GraphQL and pay $0.01 USDC on Base per query — no API key needed) and a legacy query_url (Studio API key required).",
+        "description": "Search and filter the classified subgraph registry (15,500+ subgraphs). Filter by domain (defi, nfts, dao, gaming, identity, infrastructure, social, analytics), network (mainnet, arbitrum-one, base, matic, bsc, optimism, avalanche), protocol_type (dex, lending, bridge, staking, options, perpetuals, nft-marketplace, yield-aggregator, governance, name-service), canonical entity type (liquidity_pool, trade, token, position, vault, loan, collateral, liquidation, nft_collection, nft_item, nft_sale, proposal, delegate, domain_name, account, transaction, daily_snapshot, hourly_snapshot), or free-text keyword. Returns subgraphs ranked by reliability score. Each result includes query_url_x402 (POST GraphQL and pay $0.01 USDC on Base per query — no API key needed) and a legacy query_url (Studio API key required), plus age_days and maturity (new | emerging | established). Because reliability_score is cumulative it structurally favours older deployments, so a separate `emerging` list carries recent matches that ranked below the main cut for age rather than quality — read `emerging_caveat` before offering one to a user.",
         "tags": [
           "mcp-tools"
         ],
@@ -57,12 +57,27 @@
                   },
                   "min_reliability": {
                     "type": "number",
-                    "description": "Minimum reliability score (0-1). Higher = more query fees, volume, curation signal, and indexer allocation."
+                    "description": "Minimum reliability score (0-1). Higher = more query fees, volume, curation signal, and indexer allocation. NOTE: all four inputs are cumulative, so this score rises with age — setting a floor here filters out good recent subgraphs along with bad ones."
                   },
                   "limit": {
                     "type": "integer",
                     "description": "Max results to return (default: 20)",
                     "default": 20
+                  },
+                  "include_unserved": {
+                    "type": "boolean",
+                    "description": "Include subgraphs with 0 active indexer allocations (returns 'no allocations' on query). Default false.",
+                    "default": false
+                  },
+                  "include_denied": {
+                    "type": "boolean",
+                    "description": "Include curation-denied deployments (deniedAt > 0 — denied indexing rewards, typically spam, duplicates or deprecations). Default false. When true, each result carries denied: true so the choice stays visible.",
+                    "default": false
+                  },
+                  "include_testnets": {
+                    "type": "boolean",
+                    "description": "Include testnet deployments (sepolia, goerli, holesky, chapel, fuji, mumbai, amoy, *-testnet). Default false — a testnet twin's text is near-identical to its mainnet original, so it competes for the top slot without being the thing anyone wanted. Ignored when you explicitly request a testnet network, so network:\"sepolia\" still works. Each result carries testnet: true|false.",
+                    "default": false
                   }
                 }
               }
@@ -282,6 +297,16 @@
                     "description": "Include subgraphs with 0 active indexer allocations (returns 'no allocations' on query). Default false.",
                     "default": false
                   },
+                  "include_denied": {
+                    "type": "boolean",
+                    "description": "Include curation-denied deployments (deniedAt > 0 — denied indexing rewards, typically spam, duplicates or deprecations). Default false. When true, each result carries denied: true so the choice stays visible.",
+                    "default": false
+                  },
+                  "include_testnets": {
+                    "type": "boolean",
+                    "description": "Include testnet deployments (sepolia, goerli, holesky, chapel, fuji, mumbai, amoy, *-testnet). Default false — a testnet twin's text is near-identical to its mainnet original, so it competes for the top slot without being the thing anyone wanted. Ignored when you explicitly request a testnet network, so network:\"sepolia\" still works. Each result carries testnet: true|false.",
+                    "default": false
+                  },
                   "domain": {
                     "type": "string",
                     "description": "Pre-filter by domain (defi, nfts, dao, gaming, identity, infrastructure, social, analytics)"
@@ -433,6 +458,38 @@
         }
       }
     },
+    "/graphql": {
+      "post": {
+        "operationId": "rest_post_graphql",
+        "summary": "payql compatibility — search results in subgraphMetadataSearch shape",
+        "tags": [
+          "rest"
+        ],
+        "responses": {
+          "200": {
+            "description": "{ data: { subgraphMetadataSearch: [...] } }",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "description": "{ data: { subgraphMetadataSearch: [...] } }"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ToolError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/.well-known/subgraph/{id}.jsonld": {
       "get": {
         "operationId": "rest_get_well_known_subgraph_id_jsonld",

package/openapi.yaml

@@ -5,7 +5,7 @@ openapi: "3.1.0"
 info:
   title: "Subgraph Registry"
   description: "Agent-friendly subgraph discovery on The Graph Network. 14,700+ classified subgraphs with semantic search, reliability scoring, schema-evolution tracking, and x402 query URLs ($0.01 USDC on Base, no API key)."
-  version: "0.8.31"
+  version: "0.9.3"
   license:
     name: "MIT"
   contact:
@@ -19,7 +19,7 @@ paths:
     post:
       operationId: "tool_search_subgraphs"
       summary: "Search and filter the classified subgraph registry (15,500+ subgraphs)."
-      description: "Search and filter the classified subgraph registry (15,500+ subgraphs). Filter by domain (defi, nfts, dao, gaming, identity, infrastructure, social, analytics), network (mainnet, arbitrum-one, base, matic, bsc, optimism, avalanche), protocol_type (dex, lending, bridge, staking, options, perpetuals, nft-marketplace, yield-aggregator, governance, name-service), canonical entity type (liquidity_pool, trade, token, position, vault, loan, collateral, liquidation, nft_collection, nft_item, nft_sale, proposal, delegate, domain_name, account, transaction, daily_snapshot, hourly_snapshot), or free-text keyword. Returns subgraphs ranked by reliability score. Each result includes query_url_x402 (POST GraphQL and pay $0.01 USDC on Base per query — no API key needed) and a legacy query_url (Studio API key required)."
+      description: "Search and filter the classified subgraph registry (15,500+ subgraphs). Filter by domain (defi, nfts, dao, gaming, identity, infrastructure, social, analytics), network (mainnet, arbitrum-one, base, matic, bsc, optimism, avalanche), protocol_type (dex, lending, bridge, staking, options, perpetuals, nft-marketplace, yield-aggregator, governance, name-service), canonical entity type (liquidity_pool, trade, token, position, vault, loan, collateral, liquidation, nft_collection, nft_item, nft_sale, proposal, delegate, domain_name, account, transaction, daily_snapshot, hourly_snapshot), or free-text keyword. Returns subgraphs ranked by reliability score. Each result includes query_url_x402 (POST GraphQL and pay $0.01 USDC on Base per query — no API key needed) and a legacy query_url (Studio API key required), plus age_days and maturity (new | emerging | established). Because reliability_score is cumulative it structurally favours older deployments, so a separate `emerging` list carries recent matches that ranked below the main cut for age rather than quality — read `emerging_caveat` before offering one to a user."
       tags:
         - "mcp-tools"
       requestBody:
@@ -47,11 +47,23 @@ paths:
                   description: "Filter by canonical entity: liquidity_pool, trade, token, position, vault, loan, etc."
                 min_reliability:
                   type: "number"
-                  description: "Minimum reliability score (0-1). Higher = more query fees, volume, curation signal, and indexer allocation."
+                  description: "Minimum reliability score (0-1). Higher = more query fees, volume, curation signal, and indexer allocation. NOTE: all four inputs are cumulative, so this score rises with age — setting a floor here filters out good recent subgraphs along with bad ones."
                 limit:
                   type: "integer"
                   description: "Max results to return (default: 20)"
                   default: 20
+                include_unserved:
+                  type: "boolean"
+                  description: "Include subgraphs with 0 active indexer allocations (returns 'no allocations' on query). Default false."
+                  default: false
+                include_denied:
+                  type: "boolean"
+                  description: "Include curation-denied deployments (deniedAt > 0 — denied indexing rewards, typically spam, duplicates or deprecations). Default false. When true, each result carries denied: true so the choice stays visible."
+                  default: false
+                include_testnets:
+                  type: "boolean"
+                  description: "Include testnet deployments (sepolia, goerli, holesky, chapel, fuji, mumbai, amoy, *-testnet). Default false — a testnet twin's text is near-identical to its mainnet original, so it competes for the top slot without being the thing anyone wanted. Ignored when you explicitly request a testnet network, so network:\"sepolia\" still works. Each result carries testnet: true|false."
+                  default: false
       responses:
         "200":
           description: "Tool result (JSON-encoded)"
@@ -194,6 +206,14 @@ paths:
                   type: "boolean"
                   description: "Include subgraphs with 0 active indexer allocations (returns 'no allocations' on query). Default false."
                   default: false
+                include_denied:
+                  type: "boolean"
+                  description: "Include curation-denied deployments (deniedAt > 0 — denied indexing rewards, typically spam, duplicates or deprecations). Default false. When true, each result carries denied: true so the choice stays visible."
+                  default: false
+                include_testnets:
+                  type: "boolean"
+                  description: "Include testnet deployments (sepolia, goerli, holesky, chapel, fuji, mumbai, amoy, *-testnet). Default false — a testnet twin's text is near-identical to its mainnet original, so it competes for the top slot without being the thing anyone wanted. Ignored when you explicitly request a testnet network, so network:\"sepolia\" still works. Each result carries testnet: true|false."
+                  default: false
                 domain:
                   type: "string"
                   description: "Pre-filter by domain (defi, nfts, dao, gaming, identity, infrastructure, social, analytics)"
@@ -287,6 +307,26 @@ paths:
             application/json:
               schema:
                 "$ref": "#/components/schemas/ToolError"
+  "/graphql":
+    post:
+      operationId: "rest_post_graphql"
+      summary: "payql compatibility — search results in subgraphMetadataSearch shape"
+      tags:
+        - "rest"
+      responses:
+        "200":
+          description: "{ data: { subgraphMetadataSearch: [...] } }"
+          content:
+            application/json:
+              schema:
+                type: "object"
+                description: "{ data: { subgraphMetadataSearch: [...] } }"
+        "404":
+          description: "Not found"
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/ToolError"
   "/.well-known/subgraph/{id}.jsonld":
     get:
       operationId: "rest_get_well_known_subgraph_id_jsonld"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "subgraph-registry-mcp",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "mcpName": "io.github.PaulieB14/subgraph-registry-mcp",
   "description": "MCP server for agent-friendly subgraph discovery on The Graph Network. 15,330 classified subgraphs with x402 query URLs ($0.01 USDC on Base, no API key required), reliability scoring, and protocol classification.",
   "type": "module",
@@ -18,7 +18,9 @@
     "start": "node src/index.js",
     "start:http": "node src/index.js --http",
     "start:http-only": "node src/index.js --http-only",
-    "test": "node --test test/"
+    "test": "node --test test/",
+    "sync:server": "node scripts/sync-server-json.js",
+    "version": "node scripts/sync-server-json.js && node scripts/gen-openapi.js && git add server.json openapi.yaml data/openapi.json"
   },
   "keywords": [
     "mcp",

package/src/index.js

@@ -1640,6 +1640,14 @@ export const REST_ROUTES = [
       required: ["status", "subgraphs"],
     },
   },
+  {
+    method: "post",
+    path: "/graphql",
+    summary: "payql compatibility — search results in subgraphMetadataSearch shape",
+    description:
+      "Answers a `subgraphMetadataSearch` query in The Graph network subgraph's shape, so payql (PAYQL_REGISTRY_URL) can use this registry as a free discovery source with no change on its side. Only the `text` and `first` variables are read; results come from the same index search_subgraphs uses.",
+    response: { type: "object", description: "{ data: { subgraphMetadataSearch: [...] } }" },
+  },
   {
     method: "get",
     path: "/.well-known/subgraph/{id}.jsonld",