subgraph-registry-mcp 0.8.21 → 0.8.23

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.21",
+    "version": "0.8.23",
     "license": {
       "name": "MIT"
     },

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.21"
+  version: "0.8.23"
   license:
     name: "MIT"
   contact:

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "subgraph-registry-mcp",
-  "version": "0.8.21",
+  "version": "0.8.23",
   "mcpName": "io.github.PaulieB14/subgraph-registry-mcp",
-  "description": "MCP server for agent-friendly subgraph discovery on The Graph Network. 15,246 classified subgraphs with x402 query URLs ($0.01 USDC on Base, no API key required), reliability scoring, and protocol classification.",
+  "description": "MCP server for agent-friendly subgraph discovery on The Graph Network. 15,254 classified subgraphs with x402 query URLs ($0.01 USDC on Base, no API key required), reliability scoring, and protocol classification.",
   "type": "module",
   "bin": {
     "subgraph-registry-mcp": "src/index.js"

package/src/index.js

@@ -50,7 +50,7 @@ const GITHUB_DB_URL =
 //   3. Paste the new hash here and bump package.json version
 //   4. Update SKILL.md "Verifying the registry" section
 const EXPECTED_DB_SHA256 =
-  "70e3059ba9b9f4a61350f165cf27d1db1a11f8f0f90a3b34175ab69cb805f7b0";
+  "9ebf78b72b45338dcc04326ad9d9caf4bda0e323b50ce5f381f106afdd551839";
 // Skip-verification escape hatch (set to "1" only if you're rebuilding the DB
 // locally and know what you're doing — never set in agent-runtime defaults).
 const SKIP_VERIFY = process.env.SUBGRAPH_REGISTRY_SKIP_VERIFY === "1";
@@ -221,7 +221,7 @@ function searchSubgraphs({
   const sql = `
     SELECT id, display_name, description, auto_description, domain, protocol_type, network,
            reliability_score, ipfs_hash, entity_count, canonical_entities,
-           powered_by_substreams, active_allocation_count
+           powered_by_substreams, active_allocation_count, example_query
     FROM subgraphs
     ${where}
     ORDER BY reliability_score DESC
@@ -249,6 +249,9 @@ function searchSubgraphs({
       canonical_entities: JSON.parse(r.canonical_entities),
       powered_by_substreams: Boolean(r.powered_by_substreams),
       active_allocation_count: r.active_allocation_count || 0,
+      // Ready-to-run GraphQL generated from this subgraph's actual schema — so an
+      // agent can POST it to query_url_x402 immediately, no get_subgraph_detail round-trip.
+      example_query: r.example_query || null,
       ...buildQueryEndpoints(r.id),
     });
     if (results.length >= limit) break;
@@ -257,7 +260,7 @@ function searchSubgraphs({
   return {
     total: results.length,
     subgraphs: results,
-    query_instructions: "Two ways to query: (a) RECOMMENDED — POST GraphQL to query_url_x402 and pay $0.01 USDC on Base per query via x402 (no API key required; gateway returns HTTP 402 with a payment manifest, use an x402 client like @graphprotocol/client-x402 to sign and retry). (b) LEGACY — replace [api-key] in query_url with a Graph API key from https://thegraph.com/studio/apikeys/. Call get_subgraph_detail first for the schema.",
+    query_instructions: "Two ways to query: (a) RECOMMENDED — POST GraphQL to query_url_x402 and pay $0.01 USDC on Base per query via x402 (no API key required; gateway returns HTTP 402 with a payment manifest, use an x402 client like @graphprotocol/client-x402 to sign and retry). (b) LEGACY — replace [api-key] in query_url with a Graph API key from https://thegraph.com/studio/apikeys/. Each result includes a ready-to-run `example_query` generated from that subgraph's real schema — POST it to query_url_x402 as-is, or adapt the entity/fields. Use get_subgraph_detail for the full schema.",
   };
 }
 
@@ -320,7 +323,7 @@ function recommendSubgraph({ goal, chain = "" }) {
   const where = `WHERE ${conditions.join(" AND ")}`;
   const sql = `
     SELECT id, display_name, description, auto_description, domain, protocol_type, network,
-           reliability_score, ipfs_hash, canonical_entities, active_allocation_count
+           reliability_score, ipfs_hash, canonical_entities, active_allocation_count, example_query
     FROM subgraphs
     ${where}
     ORDER BY reliability_score DESC
@@ -357,6 +360,7 @@ function recommendSubgraph({ goal, chain = "" }) {
       ipfs_hash: r.ipfs_hash,
       canonical_entities: JSON.parse(r.canonical_entities),
       active_allocation_count: r.active_allocation_count || 0,
+      example_query: r.example_query || null,
       schema_changed_at: stab.schema_changed_at,
       schema_stable_days: stab.schema_stable_days,
       ...buildQueryEndpoints(r.id),
@@ -604,7 +608,9 @@ async function semanticSearchSubgraphs({
   // SQL pre-filter shaves ~14k → <1k rows for narrow queries (e.g.
   // "lending positions on Arbitrum"). Cosine math runs only on the
   // post-filter set.
-  const conditions = ["embedding IS NOT NULL"];
+  // Exclude the handful of null-ipfs "shell" rows — they carry embeddings but
+  // are unqueryable (no deployment) so they must not surface as recommendations.
+  const conditions = ["embedding IS NOT NULL", "ipfs_hash != ''", "ipfs_hash IS NOT NULL"];
   const params = [];
   if (!include_unserved) {
     conditions.push("active_allocation_count > 0");
@@ -631,7 +637,7 @@ async function semanticSearchSubgraphs({
       `SELECT id, display_name, description, auto_description, domain,
               protocol_type, network, reliability_score, ipfs_hash,
               entity_count, canonical_entities, powered_by_substreams,
-              active_allocation_count, embedding
+              active_allocation_count, example_query, embedding
        FROM subgraphs
        ${where}`,
     )
@@ -666,6 +672,7 @@ async function semanticSearchSubgraphs({
       canonical_entities: JSON.parse(r.canonical_entities),
       powered_by_substreams: Boolean(r.powered_by_substreams),
       active_allocation_count: r.active_allocation_count || 0,
+      example_query: r.example_query || null,
       semantic_score: Number(score.toFixed(4)),
       ...buildQueryEndpoints(r.id),
     });