subgraph-registry-mcp 0.9.3 → 0.9.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  Agent-friendly semantic classification of all subgraphs on [The Graph Network](https://thegraph.com).
8
8
 
9
- Pre-computed index of **14,700+ subgraphs** with domain classification, protocol type detection, schema fingerprinting, canonical entity mapping, and composite reliability scoring.
9
+ Pre-computed index of **15,330 subgraphs** with domain classification, protocol type detection, schema fingerprinting, canonical entity mapping, and composite reliability scoring.
10
10
 
11
11
  > **What's new in 0.8.0** — three agent-discovery upgrades:
12
12
  > - **[Semantic search](#semantic-search)** via 384-dim embeddings (`semantic_search_subgraphs`)
@@ -100,14 +100,15 @@ Explore subgraphs by use case — each file lists the top 25 subgraphs ranked by
100
100
 
101
101
  | Domain | Count | File |
102
102
  |--------|-------|------|
103
- | [DeFi](docs/domains/defi.md) | 11,218 | Swaps, pools, lending, vaults, yield |
104
- | [NFTs](docs/domains/nfts.md) | 857 | Collections, marketplaces, sales |
105
- | [Infrastructure](docs/domains/infrastructure.md) | 581 | Indexers, oracles, registries |
106
- | [DAO](docs/domains/dao.md) | 429 | Governance, proposals, voting |
107
- | [Identity](docs/domains/identity.md) | 401 | ENS, name services, resolvers |
108
- | [Analytics](docs/domains/analytics.md) | 327 | Snapshots, metrics, historical data |
109
- | [Gaming](docs/domains/gaming.md) | 247 | Players, quests, items, worlds |
110
- | [Social](docs/domains/social.md) | 74 | Profiles, posts, follows |
103
+ | [DeFi](docs/domains/defi.md) | 7,844 | Swaps, pools, lending, vaults, yield |
104
+ | [NFTs](docs/domains/nfts.md) | 1,565 | Collections, marketplaces, sales |
105
+ | Unclassified | 1,333 | Not confidently classified |
106
+ | [Infrastructure](docs/domains/infrastructure.md) | 1,251 | Indexers, oracles, registries |
107
+ | [Identity](docs/domains/identity.md) | 1,061 | ENS, name services, resolvers |
108
+ | [Analytics](docs/domains/analytics.md) | 766 | Snapshots, metrics, historical data |
109
+ | [DAO](docs/domains/dao.md) | 758 | Governance, proposals, voting |
110
+ | [Gaming](docs/domains/gaming.md) | 585 | Players, quests, items, worlds |
111
+ | [Social](docs/domains/social.md) | 167 | Profiles, posts, follows |
111
112
 
112
113
  Full index: [`docs/DOMAINS.md`](docs/DOMAINS.md)
113
114
 
@@ -117,13 +118,13 @@ Explore subgraphs by blockchain — each file lists the top 25 subgraphs on that
117
118
 
118
119
  | Network | Count | File |
119
120
  |---------|-------|------|
120
- | [Ethereum](docs/networks/mainnet.md) | 2,377 | Largest ecosystem |
121
- | [Base](docs/networks/base.md) | 1,728 | Fast-growing L2 |
122
- | [BSC](docs/networks/bsc.md) | 1,582 | BNB Chain |
123
- | [Arbitrum](docs/networks/arbitrum-one.md) | 1,376 | Leading L2 |
124
- | [Polygon](docs/networks/matic.md) | 1,266 | Polygon PoS |
125
- | [Optimism](docs/networks/optimism.md) | 568 | OP Stack L2 |
126
- | [Avalanche](docs/networks/avalanche.md) | 440 | C-Chain |
121
+ | [Ethereum](docs/networks/mainnet.md) | 2,484 | Largest ecosystem |
122
+ | [Base](docs/networks/base.md) | 1,841 | Fast-growing L2 |
123
+ | [BSC](docs/networks/bsc.md) | 1,670 | BNB Chain |
124
+ | [Arbitrum](docs/networks/arbitrum-one.md) | 1,437 | Leading L2 |
125
+ | [Polygon](docs/networks/matic.md) | 1,304 | Polygon PoS |
126
+ | [Optimism](docs/networks/optimism.md) | 580 | OP Stack L2 |
127
+ | [Avalanche](docs/networks/avalanche.md) | 453 | C-Chain |
127
128
 
128
129
  Full index: [`docs/NETWORKS.md`](docs/NETWORKS.md)
129
130
 
@@ -131,16 +132,16 @@ Full index: [`docs/NETWORKS.md`](docs/NETWORKS.md)
131
132
 
132
133
  | Type | Count | Description |
133
134
  |------|-------|-------------|
134
- | DEX | 4,176 | Uniswap, Sushi, Curve, Balancer, PancakeSwap |
135
- | Lending | 1,424 | Aave, Compound, Morpho, Spark, Silo |
136
- | Staking | 867 | Lido, Rocket Pool, EigenLayer, Graph Network |
137
- | Bridge | 771 | Hop, Stargate, Across, Wormhole, LayerZero |
138
- | NFT Marketplace | 436 | OpenSea, Blur, Rarible, Foundation |
139
- | Governance | 416 | Snapshot, Tally, Compound Governor |
140
- | Yield Aggregator | 387 | Yearn, Beefy, Harvest, Convex |
141
- | Perpetuals | 266 | GMX, Gains, dYdX, Hyperliquid |
142
- | Name Service | 223 | ENS, Space ID, Unstoppable Domains |
143
- | Options | 179 | Premia, Dopex, Lyra, Hegic |
135
+ | DEX | 4,411 | Uniswap, Sushi, Curve, Balancer, PancakeSwap |
136
+ | Lending | 1,469 | Aave, Compound, Morpho, Spark, Silo |
137
+ | Staking | 898 | Lido, Rocket Pool, EigenLayer, Graph Network |
138
+ | Bridge | 836 | Hop, Stargate, Across, Wormhole, LayerZero |
139
+ | NFT Marketplace | 450 | OpenSea, Blur, Rarible, Foundation |
140
+ | Yield Aggregator | 425 | Yearn, Beefy, Harvest, Convex |
141
+ | Governance | 425 | Snapshot, Tally, Compound Governor |
142
+ | Perpetuals | 273 | GMX, Gains, dYdX, Hyperliquid |
143
+ | Name Service | 227 | ENS, Space ID, Unstoppable Domains |
144
+ | Options | 192 | Premia, Dopex, Lyra, Hegic |
144
145
 
145
146
  ---
146
147
 
package/data/openapi.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "info": {
4
4
  "title": "Subgraph Registry",
5
5
  "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).",
6
- "version": "0.9.3",
6
+ "version": "0.9.4",
7
7
  "license": {
8
8
  "name": "MIT"
9
9
  },
@@ -22,8 +22,8 @@
22
22
  "/mcp/tools/search_subgraphs": {
23
23
  "post": {
24
24
  "operationId": "tool_search_subgraphs",
25
- "summary": "Search and filter the classified subgraph registry (15,500+ subgraphs).",
26
- "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.",
25
+ "summary": "Search and filter the classified subgraph registry (15,000+ subgraphs).",
26
+ "description": "Search and filter the classified subgraph registry (15,000+ 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.",
27
27
  "tags": [
28
28
  "mcp-tools"
29
29
  ],
package/openapi.yaml CHANGED
@@ -5,7 +5,7 @@ openapi: "3.1.0"
5
5
  info:
6
6
  title: "Subgraph Registry"
7
7
  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)."
8
- version: "0.9.3"
8
+ version: "0.9.4"
9
9
  license:
10
10
  name: "MIT"
11
11
  contact:
@@ -18,8 +18,8 @@ paths:
18
18
  "/mcp/tools/search_subgraphs":
19
19
  post:
20
20
  operationId: "tool_search_subgraphs"
21
- summary: "Search and filter the classified subgraph registry (15,500+ subgraphs)."
22
- 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."
21
+ summary: "Search and filter the classified subgraph registry (15,000+ subgraphs)."
22
+ description: "Search and filter the classified subgraph registry (15,000+ 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."
23
23
  tags:
24
24
  - "mcp-tools"
25
25
  requestBody:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "subgraph-registry-mcp",
3
- "version": "0.9.3",
3
+ "version": "0.9.4",
4
4
  "mcpName": "io.github.PaulieB14/subgraph-registry-mcp",
5
5
  "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.",
6
6
  "type": "module",
package/src/index.js CHANGED
@@ -1237,7 +1237,7 @@ const TOOLS = [
1237
1237
  {
1238
1238
  name: "search_subgraphs",
1239
1239
  description:
1240
- "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.",
1240
+ "Search and filter the classified subgraph registry (15,000+ 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.",
1241
1241
  inputSchema: {
1242
1242
  type: "object",
1243
1243
  additionalProperties: false,