Skip to content

Commit 975859a

Browse files
brandonleekramerbenface
brandonleekramer
and
benface
authored
Removing AI standalone section, moving MCP/Skills to product sections… (#1106)
* Removing AI standalone section, moving MCP/Skills to product sections, updated About page * updating about page * Added AGENTS.md file * Adjusting Layout.tsx * Remove remaining mentions of `ai-suite` + fix links + remove `AGENTS.md` as discussed with BK (the website will have `llms.txt`) --------- Co-authored-by: benface <benoit.rouleau@icloud.com>
1 parent 3429e5f commit 975859a

22 files changed

Lines changed: 76 additions & 66 deletions

‎nginx.conf‎

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -112,7 +112,6 @@ http {
112112
rewrite ^/docs/en/explorer/$ $scheme://$http_host/docs/en/subgraphs/explorer/ permanent;
113113
rewrite ^/docs/en/firehose/$ $scheme://$http_host/docs/en/indexing/tooling/firehose/ permanent;
114114
rewrite ^/docs/en/glossary/$ $scheme://$http_host/docs/en/resources/glossary/ permanent;
115-
rewrite ^/docs/en/graph-assistant/quick-start/$ $scheme://$http_host/docs/en/ai-suite/graph-assistant/quick-start/ permanent;
116115
rewrite ^/docs/en/graphcast/$ $scheme://$http_host/docs/en/indexing/tooling/graphcast/ permanent;
117116
rewrite ^/docs/en/indexing/$ $scheme://$http_host/docs/en/indexing/overview/ permanent;
118117
rewrite ^/docs/en/managing/delete-a-subgraph/$ $scheme://$http_host/docs/en/subgraphs/developing/managing/deleting-a-subgraph/ permanent;
@@ -155,10 +154,6 @@ http {
155154
rewrite ^/docs/en/studio/subgraph-studio/$ $scheme://$http_host/docs/en/subgraphs/developing/deploying/using-subgraph-studio/ permanent;
156155
rewrite ^/docs/en/studio/transferring-subgraph-ownership/$ $scheme://$http_host/docs/en/subgraphs/developing/managing/transferring-a-subgraph/ permanent;
157156
rewrite ^/docs/en/subgraphs/$ $scheme://$http_host/docs/en/subgraphs/quick-start/ permanent;
158-
rewrite ^/docs/en/subgraphs/mcp/claude/$ $scheme://$http_host/docs/en/ai-suite/subgraph-mcp/ permanent;
159-
rewrite ^/docs/en/subgraphs/mcp/cline/$ $scheme://$http_host/docs/en/ai-suite/subgraph-mcp/ permanent;
160-
rewrite ^/docs/en/subgraphs/mcp/cursor/$ $scheme://$http_host/docs/en/ai-suite/subgraph-mcp/ permanent;
161-
rewrite ^/docs/en/subgraphs/mcp/cline/$ $scheme://$http_host/docs/en/ai-suite/subgraph-mcp/ permanent;
162157
rewrite ^/docs/en/substreams/$ $scheme://$http_host/docs/en/substreams/quick-start/ permanent;
163158
rewrite ^/docs/en/substreams/developing/sinks/sinks/$ $scheme://$http_host/docs/en/substreams/developing/sinks/ permanent;
164159
rewrite ^/docs/en/substreams/sps/$ $scheme://$http_host/docs/en/substreams/sps/introduction/ permanent;
@@ -168,6 +163,14 @@ http {
168163
rewrite ^/docs/en/supported-networks/near/$ $scheme://$http_host/docs/en/subgraphs/cookbook/near/ permanent;
169164
rewrite ^/docs/en/tap/$ $scheme://$http_host/docs/en/indexing/tap/ permanent;
170165
rewrite ^/docs/en/tokenomics/$ $scheme://$http_host/docs/en/resources/tokenomics/ permanent;
166+
rewrite ^/docs/en/ai-suite/$ $scheme://$http_host/docs/en/ai-overview/ permanent;
167+
rewrite ^/docs/en/ai-suite/ai-introduction/$ $scheme://$http_host/docs/en/ai-overview/ permanent;
168+
rewrite ^/docs/en/ai-suite/subgraph-skills/$ $scheme://$http_host/docs/en/subgraphs/skills/ permanent;
169+
rewrite ^/docs/en/ai-suite/subgraph-mcp/$ $scheme://$http_host/docs/en/subgraphs/subgraph-mcp/introduction/ permanent;
170+
rewrite ^/docs/en/subgraphs/subgraph-mcp/$ $scheme://$http_host/docs/en/subgraphs/subgraph-mcp/introduction/ permanent;
171+
rewrite ^/docs/en/ai-suite/substreams-skills/$ $scheme://$http_host/docs/en/substreams/skills/ permanent;
172+
rewrite ^/docs/en/ai-suite/substreams-mcp/$ $scheme://$http_host/docs/en/substreams/substreams-mcp/search/ permanent;
173+
rewrite ^/docs/en/substreams/substreams-mcp/$ $scheme://$http_host/docs/en/substreams/substreams-mcp/search/ permanent;
171174

172175
# Token API redirects
173176
rewrite ^/docs/en/token-api/quick-start/$ https://app.pinax.network/docs/api/ permanent;

‎website/next.config.js‎

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -67,10 +67,7 @@ const withNextra = nextra({
6767
'---3': {
6868
type: 'separator',
6969
},
70-
'ai-suite': {
71-
type: 'children',
72-
title: t('global.navigation.ai-suite'),
73-
},
70+
'ai-overview': '',
7471
'---4': {
7572
type: 'separator',
7673
},

‎website/route-lockfile.txt‎

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,7 @@
22
/en/
33
/en/404/
44
/en/about/
5-
/en/ai-suite/ai-introduction/
6-
/en/ai-suite/subgraph-mcp/claude/
7-
/en/ai-suite/subgraph-mcp/cline/
8-
/en/ai-suite/subgraph-mcp/cursor/
9-
/en/ai-suite/subgraph-mcp/introduction/
10-
/en/ai-suite/subgraph-skills/
11-
/en/ai-suite/substreams-mcp/search/
12-
/en/ai-suite/substreams-skills/
5+
/en/ai-overview/
136
/en/archived/arbitrum/arbitrum-faq/
147
/en/archived/arbitrum/l2-transfer-tools-faq/
158
/en/archived/arbitrum/l2-transfer-tools-guide/
@@ -90,6 +83,11 @@
9083
/en/subgraphs/querying/python/
9184
/en/subgraphs/querying/subgraph-id-vs-deployment-id/
9285
/en/subgraphs/quick-start/
86+
/en/subgraphs/skills/
87+
/en/subgraphs/subgraph-mcp/claude/
88+
/en/subgraphs/subgraph-mcp/cline/
89+
/en/subgraphs/subgraph-mcp/cursor/
90+
/en/subgraphs/subgraph-mcp/introduction/
9391
/en/subgraphs/upgrade-indexer/
9492
/en/substreams/developing/dev-container/
9593
/en/substreams/developing/sinks/
@@ -98,16 +96,18 @@
9896
/en/substreams/introduction/
9997
/en/substreams/publishing/
10098
/en/substreams/quick-start/
99+
/en/substreams/skills/
100+
/en/substreams/substreams-mcp/search/
101101
/en/supported-networks/
102102
/en/supported-networks/arbitrum-nova/
103103
/en/supported-networks/arbitrum-one/
104104
/en/supported-networks/arbitrum-sepolia/
105105
/en/supported-networks/arc-testnet/
106+
/en/supported-networks/arc/
106107
/en/supported-networks/avalanche/
107108
/en/supported-networks/base-sepolia/
108109
/en/supported-networks/base/
109110
/en/supported-networks/blast-mainnet/
110-
/en/supported-networks/bnb-op/
111111
/en/supported-networks/bnb-svm/
112112
/en/supported-networks/boba-testnet/
113113
/en/supported-networks/boba/
@@ -143,7 +143,6 @@
143143
/en/supported-networks/jungle4/
144144
/en/supported-networks/kaia-testnet/
145145
/en/supported-networks/kaia/
146-
/en/supported-networks/katana/
147146
/en/supported-networks/linea-sepolia/
148147
/en/supported-networks/linea/
149148
/en/supported-networks/litecoin/
@@ -165,7 +164,6 @@
165164
/en/supported-networks/polygon-amoy/
166165
/en/supported-networks/polygon-zkevm-cardona/
167166
/en/supported-networks/polygon-zkevm/
168-
/en/supported-networks/ronin/
169167
/en/supported-networks/rootstock-testnet/
170168
/en/supported-networks/rootstock/
171169
/en/supported-networks/scroll-sepolia/

‎website/src/layout/Layout.tsx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -192,7 +192,7 @@ export default function Layout({ pageOpts, children }: NextraThemeLayoutProps<Fr
192192
if (routeWithoutLocale === '/substreams' || routeWithoutLocale.startsWith('/substreams/')) {
193193
return <Substreams alt="" />
194194
}
195-
if (routeWithoutLocale === '/ai-suite' || routeWithoutLocale.startsWith('/ai-suite/')) {
195+
if (routeWithoutLocale === '/ai-overview' || routeWithoutLocale.startsWith('/ai-overview/')) {
196196
return <Sparkle alt="" variant={selected ? 'fill' : 'regular'} />
197197
}
198198
if (routeWithoutLocale === '/indexing' || routeWithoutLocale.startsWith('/indexing/')) {

‎website/src/pages/en/about.mdx‎

Lines changed: 40 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -5,35 +5,58 @@ description: This page summarizes the core concepts and basics of The Graph Netw
55

66
## What is The Graph?
77

8-
The Graph is a decentralized protocol for indexing and querying blockchain data across [60+ networks](/supported-networks/).
8+
The Graph is a suite of blockchain data infrastructure products that extract, process, and deliver scalable blockchain data solutions across 60+ networks. The Graph enables application developers, data analysts, AI agents, and enterprise teams that need structured, reliable, and real-time access to blockchain data. Products include Subgraphs, Substreams, and Amp. As of early 2026, The Graph has served over 1.27 trillion queries to more than 75,000 projects, powered by 50+ independent Indexer nodes worldwide.
99

10-
Its data services include:
10+
To learn more about The Graph from a non-technical perspective, visit [The Graph Overview](https://thegraph.com/what-is-the-graph/).
1111

12-
- [Subgraphs](/subgraphs/developing/subgraphs/): Open APIs to query blockchain data that can be created or queried by anyone.
13-
- [Substreams](/substreams/introduction/): High-performance data streams for real-time blockchain processing, built with modular components.
12+
## Why Blockchain Data is Difficult to Index
1413

15-
### Why Blockchain Data is Difficult to Query
14+
Blockchains are optimized for writing and verifying transactions, not for reading or analyzing them. This makes indexing on-chain data harder than it looks:
1615

17-
Reading data from blockchains requires processing smart contract events, parsing metadata from IPFS, and manually aggregating data.
16+
- **No relational structure:** Data is stored as an append-only chain of blocks with no tables, indices, or relationships. Answering "all transfers for this user" means scanning the chain block by block, which is slow and resource intensive.
17+
- **State isn't readable in useful forms:** Contract data lives in low-level storage slots and event logs, which must be reconstructed into meaningful application-readable format.
18+
- **No query language:** Blockchains expose only low-level RPC methods (`eth_getLogs`, `eth_call`), with no native way to filter, aggregate, sort, or join.
19+
- **Historical data needs archive nodes:** Querying past state requires expensive archive nodes, since most nodes prune historical data.
20+
- **Data is fragmented:** Real applications scatter data across many contracts and events that were never designed to be joined together.
1821

19-
The result is slow performance, complex infrastructure, and scalability issues.
22+
Doing this processing on demand is slow, and it forces every developer to build and maintain their own indexing infrastructure.
2023

2124
## How The Graph Solves This
2225

23-
The Graph uses a combination of cutting-edge research, core dev expertise, and independent Indexers to make blockchain data accessible for developers.
26+
The Graph is a modular protocol whose data services each specialize in a different class of blockchain data problem. Rather than forcing every use case through a single tool, the protocol lets developers choose the right product or service for their use case:
2427

25-
Find the perfect data service for you:
28+
- **Specialized data services for specific use cases:** The protocol supports a spectrum of data services, each optimized for a distinct need. A team can use one service for custom application APIs, another for high-throughput streaming, and another for compliance-grade analytics, all secured by the same network.
29+
- **Subgraphs for resilient, decentralized APIs:** Subgraphs define exactly which contracts, events, and entities to index and how to transform raw on-chain data into structured entities queryable via GraphQL. Because a global network of Indexers serves this data, Subgraphs offer resilience and geographic diversification, with no single point of failure.
30+
- **Substreams for real-time scale:** Substreams use parallelized, streaming data processing to index at high throughput and deliver onchain data with low latency. This scales indexing far beyond sequential processing and powers real-time use cases such as live liquidity and trading data.
31+
- **Amp for verifiability and auditability:** Amp provides verifiable, enterprise-grade access to on-chain data with built-in audit trails, meeting the auditability and compliance requirements of regulated institutions.
2632

27-
### 1. Custom APIs for web3 Developers
33+
The result: raw, hard-to-access on-chain data becomes fast, structured, and ready to power applications—from a single dapp to institutional-scale systems.
2834

29-
**Use Case:** Dapp frontends, custom analytics.
35+
## The Graph's Core Products
3036

31-
- [Explore Subgraphs](https://thegraph.com/explorer)
32-
- [Build Your Subgraph](/subgraphs/quick-start)
37+
### 1. [Subgraphs](/subgraphs/developing/subgraphs/)
3338

34-
### 2. Real-Time & Historical Data Streams
39+
**Overview:** Custom APIs that extract data from a blockchain, process it, and serve it via GraphQL. The original and most widely used data service on The Graph.
3540

36-
**Use Case:** High-frequency trading, live analytics.
41+
**Use Cases:** Best when an application needs its own structured, queryable data (specific contracts, events, entities) via an opinionated API. Ideal for DeFi dashboards, NFT marketplaces, governance UIs, and most dapp frontends.
3742

38-
- [Build Substreams](/substreams/introduction/)
39-
- [Browse Community Substreams](https://substreams.dev/)
43+
- [Explore existing Subgraphs](https://thegraph.com/explorer)
44+
- [Build a Subgraph](/subgraphs/quick-start)
45+
46+
### 2. [Substreams](/substreams/introduction/)
47+
48+
**Overview:** A parallel blockchain indexing technology for high-performance, real-time data streams. Built for use cases that need faster sync and larger throughput than traditional Subgraphs.
49+
50+
**Use Case:** Best when you need low-latency data at scale: live liquidity and price feeds, trading and liquidation events, analytics pipelines, and large-scale backfills across chains.
51+
52+
- [Browse existing Substreams](https://substreams.dev/)
53+
- [Build with Substreams](/substreams/introduction/)
54+
55+
### 3. [Amp](https://ampup.sh/docs)
56+
57+
**Overview:** A blockchain-native database designed to transform onchain activity into enterprise-ready datasets with built-in compliance, auditability, and verifiability.
58+
59+
**Use Case:** Best for regulated and institutional use cases needing SQL access and built-in audit trails: enterprise analytics, financial reporting, and workflows with regulatory requirements.
60+
61+
- [Contact Team](https://www.edgeandnode.com/)
62+
- [Get Started with Amp](https://ampup.sh/docs)

website/src/pages/en/ai-suite/ai-introduction.mdx renamed to website/src/pages/en/ai-overview.mdx

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: The Graph's AI
3-
description: Build with speed and scale faster with The Graph's MCPs and skills.
2+
title: The Graph’s AI
3+
description: Build with speed and scale faster with The Graph’s MCPs and skills.
44
---
55

66
## Using AI on The Graph
77

8-
Instead of relying on static datasets or centralized APIs, you can now use our AI-native tooling via the [Subgraph MCP](/ai-suite/subgraph-mcp/introduction/), [Substreams MCP](/ai-suite/substreams-mcp/search/), and agent skills for both Subgraphs and Substreams.
8+
Instead of relying on static datasets or centralized APIs, you can now use our AI-native tooling via the [Subgraph MCP](/subgraphs/subgraph-mcp/introduction/), [Substreams MCP](/substreams/substreams-mcp/search/), and agent skills for both Subgraphs and Substreams.
99

1010
### Why Use Onchain Data with AI?
1111

@@ -23,7 +23,7 @@ Agent Skills extend AI coding assistants like Claude Code and Cursor with deep,
2323

2424
### Subgraph MCP
2525

26-
The [Subgraph MCP](/ai-suite/subgraph-mcp/introduction/) server connects models to Subgraphs on The Graph Network. It allows language models to explore Subgraph schemas, execute GraphQL queries, find relevant Subgraphs by keyword or contract, and surface usage metrics using natural language.
26+
The [Subgraph MCP](/subgraphs/subgraph-mcp/introduction/) server connects models to Subgraphs on The Graph Network. It allows language models to explore Subgraph schemas, execute GraphQL queries, find relevant Subgraphs by keyword or contract, and surface usage metrics using natural language.
2727

2828
#### Benefits of Using Subgraph MCP
2929

@@ -34,7 +34,7 @@ The [Subgraph MCP](/ai-suite/subgraph-mcp/introduction/) server connects models
3434

3535
### Substreams MCP
3636

37-
The [Substreams MCP](/ai-suite/substreams-mcp/search/) server lets AI agents search, inspect, and analyze Substreams packages — from registry discovery to sink deployment. It supports dual transport for local clients and SSE/HTTP for remote agents.
37+
The [Substreams MCP](/substreams/substreams-mcp/search/) server lets AI agents search, inspect, and analyze Substreams packages — from registry discovery to sink deployment. It supports dual transport for local clients and SSE/HTTP for remote agents.
3838

3939
#### Tools
4040

@@ -53,7 +53,7 @@ The [Substreams MCP](/ai-suite/substreams-mcp/search/) server lets AI agents sea
5353

5454
### Agent Skills for Subgraphs
5555

56-
[Subgraph Skills](/ai-suite/subgraph-skills/) is a collection of AI agent skills that provide expert knowledge for developing, testing, and deploying Subgraphs. Skills are available as Claude Code plugins or OpenClaw skills.
56+
[Subgraph Skills](/subgraphs/skills/) is a collection of AI agent skills that provide expert knowledge for developing, testing, and deploying Subgraphs. Skills are available as Claude Code plugins or OpenClaw skills.
5757

5858
#### Available Skills
5959

@@ -65,7 +65,7 @@ The [Substreams MCP](/ai-suite/substreams-mcp/search/) server lets AI agents sea
6565

6666
### Agent Skills for Substreams
6767

68-
[Substreams Skills](/ai-suite/substreams-skills/) enhance AI coding assistants with specialized Substreams expertise. Install once and your assistant automatically applies Substreams best practices when working on relevant projects.
68+
[Substreams Skills](/substreams/skills/) enhance AI coding assistants with specialized Substreams expertise. Install once and your assistant automatically applies Substreams best practices when working on relevant projects.
6969

7070
#### Available Skills
7171

‎website/src/pages/en/ai-suite/_meta-titles.json‎

Lines changed: 0 additions & 7 deletions
This file was deleted.

‎website/src/pages/en/ai-suite/_meta.js‎

Lines changed: 0 additions & 9 deletions
This file was deleted.

‎website/src/pages/en/global.json‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@
55
"hide": "Hide navigation",
66
"subgraphs": "Subgraphs",
77
"substreams": "Substreams",
8-
"ai-suite": "AI Suite",
98
"indexing": "Indexing",
109
"graph-horizon": "Graph Horizon",
1110
"resources": "Resources",

‎website/src/pages/en/subgraphs/_meta-titles.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
{
2+
"subgraph-mcp": "Subgraph MCP",
23
"querying": "Querying",
34
"developing": "Developing",
45
"guides": "How-to Guides",

0 commit comments

Comments
 (0)